home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / rmail181.zip / RBBSMAIL.DOC < prev    next >
Text File  |  1992-02-28  |  98KB  |  2,639 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                       RBBSMail, the RBBS-PC Echomail Processor
  15.                                                                   Version 18.1
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                                        (C) by Jan R.  Terpstra
  25.  
  26.  
  27.                                                              Februari 28, 1992
  28.  
  29.  
  30.                                                                  Bamestra RBBS
  31.                                                                     P.O.Box 66
  32.                                                              1462 ZH  Beemster
  33.                                                                The Netherlands
  34.                                                              RBBSNet 8:998/1.0
  35.                                                             FIDONET 2:512/10.0
  36.                                                    phone1 ++31 2998 3602 (v24)
  37.                                                    phone2 ++31 2998 3603 (HST)
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                                                      Document Number RM_920228
  47.  
  48.  
  49.  
  50.                                                                 RBBSMail v18.1
  51.   │ Revisions in this document are marked by a sidebar like  the  one  on  the
  52.   │ left of this sentence.
  53.     NOTICE: This is NOT a drop-in replacement of  RBBSMAIL.EXE,  you  need  to
  54.     change the configuration and batch files before running  this  version  of
  55.     RBBSMail!!!!!!!
  56.  
  57.  
  58.  
  59.                                  RBBSMail v18.1
  60.  
  61.  
  62.     1. WARNING!
  63.  
  64.  
  65.     Please note that RBBSMail v18.x is *NOT* a drop-in replacement for earlier
  66.     versions of RBBSMail.  Several  configuration  phrases  and  command  line
  67.     switches have changed.  You *MUST* make changes  to  RBBSMAIL.CFG  and  to
  68.     your batchfiles invoking RBBSMail to prevent sending out messages that may
  69.     not confirm to current FIDONET echomail distribution standards.
  70.  
  71.     What  you  should  do  before  installing  and  running  this  version  of
  72.     RBBSMail.
  73.  
  74.     ■   Delete all .EID files from your  system.   RBBSMail  v18  uses  a  new
  75.         method of checking for duplicates.
  76.     ■   In the directory where you run RBBSMail, type the command
  77.         ATTRIB RBBSMAIL.NUM -S -H (DOS 5.0) and delete the file RBBSMAIL.NUM.
  78.     ■   Read this document and make the required changes to your  RBBSMAIL.CFG
  79.         and AREA.BBS files.
  80.     ■   Note that the command line switches of RBBSMail have changed.  Earlier
  81.         versions used a colon ":" as command delimiter.  RBBSMail v18  uses  a
  82.         space between command line switch and parameter.
  83.     ■   Type RBBSMAIL with the appropriate command line switches and cross you
  84.         fingers.
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.     WARNING!                                                                 1
  119.  
  120.  
  121.  
  122.                                  RBBSMail v18.1
  123.  
  124.  
  125.     2. What is RBBSMail
  126.  
  127.  
  128.     RBBSMail is a program that allows sysops of  RBBS-PC  bulletin  boards  to
  129.     hook their bulletin board into the international FIDONET  and  participate
  130.     in Echomail.  The combination  RBBS-PC  +  RBBSMail  +  any  of  the  mail
  131.     frontends will process messages entered in designated conferences  of  the
  132.     RBBS-PC system and  send  those  messages  to  any  other  system  in  the
  133.     FIDONET.  It will put received Echomail in  the  proper  RBBS-PC  MESSAGES
  134.     file or in to FIDO style message subdirectory.
  135.  
  136.     This way, RBBS-PC conferences can be shared  among  multiple  RBBS-PC  and
  137.     other systems in the FIDONET.  Messages entered on  any  of  the  bulletin
  138.     boards in an Echomail net will eventually be copied over to all the  other
  139.     bulletin board  systems  connected  to  the  net.   RBBSMail  does  handle
  140.     reception of directly addressed FIDONET  messages  but  it  cannot  handle
  141.     explicitly addressed messages from users on  your  system  simply  because
  142.     RBBS-PC does not (yet??) provide a way  of  addressing  network  messages.
  143.     RBBSMail can only process Echomail.
  144.  
  145.     To accomodate bulletin board systems that run another BBS program next  to
  146.     RBBS-PC, RBBSMail can also do Import and Export functions  on  FIDO  style
  147.     message subdirectories, just like ConfMail, QM  and  Dutchie's  Conference
  148.     manager do.  This allows a mixed environment where both RBBS-PC and a FIDO
  149.     compatible BBS program can participate in Echomail on a single computer.
  150.  
  151.  
  152.     2.1  Software Requirements
  153.  
  154.  
  155.     To run RBBSMail, you need (of course) a  working  RBBS-PC  based  bulletin
  156.     board with a version of RBBS-PC that  will  run  with  a  frontend  mailer
  157.     (RBBS-PC v16.1A or later), RBBSMail and suitable  batch  files.   RBBSMail
  158.     can handle RBBS-PC MESSAGES files produced by RBBS-PC v16.1A and higher.
  159.  
  160.     RBBSMail will work happily with any FTS-0001 compatible front-end  mailer,
  161.     like BinkleyTerm, FrontDoor, Dutchie or SEAdog.  All programs have  strong
  162.     and week points, it is up to you to decide which one to use.
  163.  
  164.     BinkleyTerm is distributed including the C sourcecode, just like  RBBS-PC.
  165.     This makes the two programs "live with the same spirit".  The  combination
  166.     of BinkleyTerm, RBBSMail and the  FIDO  compatible  message  editor  MsgEd
  167.     (sourcecode also available) is my personal preference.
  168.  
  169.     Dutchie is a FIDO compatible mailer of  Dutch  origin  (hence  the  name).
  170.     Dutchie's older version came excellent documentation,  containing  a  very
  171.     educational section on FIDONET basics.  Sadly enough, the current level of
  172.     Dutchie's documentation is "less usefull" (pun intended).
  173.  
  174.     FrontDoor is a commercial FIDO compatible mailer of good quality.  It  has
  175.     a been a stable product for quite some time and exploits some  interesting
  176.     extras.
  177.  
  178.     SEAdog was the first commercial FIDONET compatible mailer.   While  a  bit
  179.  
  180.  
  181.     What is RBBSMail                                                         2
  182.  
  183.  
  184.  
  185.                                  RBBSMail v18.1
  186.  
  187.  
  188.     limited in functionality, it has been a reliable and stable product for  a
  189.     long time.
  190.  
  191.     D'Bridge is a  commercial  FIDONET  mailer  including  echomail  handling,
  192.     message editor, maintenance and  a  handful  of  other  utilities.   While
  193.     D'Bridge looks like a nice package at first glance,  it  has  had  a  long
  194.     lasting history of being bug-infested,  badly  supported  and  not  really
  195.     compliant with current FIDONET standards.
  196.  
  197.     When using all of RBBSMail's ARCmail abilities, you must  have  copies  of
  198.     the programs ARCA.COM, ARJ.EXE, PAK.EXE, LHA.EXE, PKZIP.EXE,  PKUNZIP.EXE,
  199.     ZOO.EXE  and  GUS.EXE,  either  in  the  current  subdirectory  or  in   a
  200.     subdirectory listed in your DOS PATH environment variable.
  201.  
  202.  
  203.     2.2  Hardware Requirements
  204.  
  205.  
  206.     The minimum hardware requirements to run RBBSMail are the  same  as  those
  207.     for RBBS-PC (think about that for a while....)
  208.  
  209.  
  210.     2.3  Limitations.
  211.  
  212.  
  213.     I hate to leave people out in the blue as to what they can and  cannot  do
  214.     with this program.  To  my  opinion,  if  a  program  has  limitations  or
  215.     restrictions, they should be documented.   Here  are  the  most  important
  216.     limititations of RBBSMail:
  217.  
  218.     ■   The main code and data of RBBSMail eat about 170  KB  of  memory,  not
  219.         including the compiled in-memory table of your AREAS.BBS.
  220.     ■   Depending on  the  amount  of  areas  you  carry  and  the  number  of
  221.         destination addressesper area, the compiled  table  of  AREAS.BBS  may
  222.         take 53 to 1516 bytes per individual area.
  223.     ■   The maximum line length of each line in AREAS.BBS is 1024 characters.
  224.     ■   The maximum size of processed messages is 32000 bytes.
  225.     ■   The maximum size of incoming and outgoing mailbundles is 2 Gigabyte.
  226.     ■   The maximum number of individual areas in AREAS.BBS is 512.
  227.     ■   The maximum number of destination addresses per area in  AREAS.BBS  is
  228.         50.
  229.     ■   The maximum number of messages in a RBBS-PC messages file is 999.
  230.     ■   The maximum number of messages in a FIDO .MSG  style  subdirectory  is
  231.         2048.
  232.     ■   The maximum number of net/node pairs in the SEEN-BY and PATH lines  is
  233.         256.
  234.     ■   The maximum length of any AREA: name is 64 characters.
  235.     ■   The  maximum  length   of   any   drive:\subdir\filename.ext   is   64
  236.         characters.
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.     What is RBBSMail                                                         3
  245.  
  246.  
  247.  
  248.                                  RBBSMail v18.1
  249.  
  250.  
  251.     2.4  Related Documents
  252.  
  253.  
  254.     I advise you (well, it is sort of mandatory) to read or  at  least  browse
  255.     through the following documents:
  256.  
  257.     ■   The manual of the frontend mailer you intend to use.
  258.     ■   SD-APDX by Kim Wells (how to run SEADOG with RBBS-PC).
  259.     ■   BT-APDX by Tony Young (how to run BinkleyTerm with RBBS-PC).
  260.     ■   The IFNA FTS documents.
  261.     ■   IFNA publications about the FIDONET.
  262.     ■   The FIDO newsletters.
  263.  
  264.     And you already read the RBBS-PC documentation, didn't you??? Or  did  you
  265.     just fire up RBBS-PC with your fingers crossed? If you are  one  of  those
  266.     who never reads documentation, you'll probably will not read  this.   But,
  267.     in case your eye accidentially catches this: Please read the documentation
  268.     before you ask any questions!!! I have had too  many  questions  asked  by
  269.     people that obviously did not read a scrap of  documentation  before  they
  270.     started what they were doing.  I have a standard answer for these  people:
  271.     R.T.F.M.!! This answer will usally solve some 95% of the  questions.   The
  272.     other 5% are 'real' problems that need some sort  of  action.   If,  after
  273.     reading  and  rereading  the  documentation  there  are  still   questions
  274.     unanswered, feel  free  to  contact  the  author  and  elaborate  on  your
  275.     problem.
  276.  
  277.  
  278.     2.5  Acknowledgements
  279.  
  280.  
  281.     It is utterly impossible to give credits were credits are  due,  but  here
  282.     are the names of some persons that have been of  great  help  and  deserve
  283.     kudos: Thom Mack, Ken Goosens and Jon Martin, authors  of  RBBS-PC.   Doug
  284.     Azzarito and Kim Wells for their many suggestions.  Jeff Rush,  author  of
  285.     TOSSMAIL and SCANMAIL, and the inventor of Echomail.   The  Binkley  Trio.
  286.     Johan Zwiekhorst for GUS and the ARCA simulator.  Bob Hartman  for  making
  287.     the  source  of  ConfMail  available.   Ron  Bemis  for  his  many  useful
  288.     suggestions and sample C code in the international NET_DEV  conference  on
  289.     FIDONET.  Mark Kimes for some refreshing ideas  and  the  wording  of  the
  290.     license agreement.
  291.     And last (but NOT least!) the people that had the courage to beta-test  my
  292.     code.  A special word of thanks to Patty  Pickett,  sysop  of  "My  Secret
  293.     Garden RBBS".  Patty asked lots of questions setting  my  brain  in  gear,
  294.     provided feedback on errors in  the  program  and  documentation  and  she
  295.     volunteered to distribute updates to the beta-testers.  Kisses, Patty! You
  296.     earned yourself an original Dutch Cheese :-)
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.     What is RBBSMail                                                         4
  308.  
  309.  
  310.  
  311.                                  RBBSMail v18.1
  312.  
  313.  
  314.   │ 3. Legal Stuff
  315.  
  316.  
  317.   │ 3.1  Copyrights & License
  318.  
  319.  
  320.   │ RBBSMail is (C) Copyright 1988...1991 by Jan R.  Terpstra.
  321.   │ Non-Commercial distribution and/or use is permitted  under  the  following
  322.   │ terms::
  323.  
  324.   │ 1 - You may copy  and  distribute  verbatim  copies  of  RBBSMail  source,
  325.   │ documentation, and executable code as  you  receive  it,  in  any  medium,
  326.   │ provided that:
  327.  
  328.   │ ■   you conspicuously and appropriately  publish  on  each  copy  a  valid
  329.   │     copyright notice "(C) Copyright 1987, 1992 by Jan R.  Terpstra";
  330.   │ ■   you keep intact the notices on all files that refer  to  this  License
  331.   │     Agreement and to the absence of any warranty;
  332.   │ ■   you provide UNMODIFIED copies of the documentation  as  provided  with
  333.   │     the program;
  334.   │ ■   you give any other recipients of the RBBSMail program a copy  of  this
  335.   │     License Agreement along with the program.
  336.  
  337.   │ 2 - You may not  charge  a  distribution  fee  for  the  physical  act  of
  338.   │ transferring a copy.  Under no circumstances is RBBSMail to be distributed
  339.   │ in such a way as to be construed as "value added" in a sales  transaction,
  340.   │ such as, but not limited to, software  bundled  with  a  modem  or  CD-ROM
  341.   │ software collections.
  342.  
  343.   │ 3 - You may modify your copy or copies of RBBSMail or any portion  of  it,
  344.   │ and copy and distribute such modifications under the terms of Paragraph  1
  345.   │ above, provided that you:
  346.  
  347.   │ ■   send a complete copy of the modified source and executables to Jan  R.
  348.   │     Terpstra at the address on the title page of this  document,  for  the
  349.   │     purpose of evaluation for inclusion in future  releases  of  RBBSMail.
  350.   │     Should your source code be included  in  RBBSMail,  Jan  R.   Terpstra
  351.   │     retains all rights for redistribution of the code as part of  RBBSMail
  352.   │     and all derivative works, with appropriate credit given to the  author
  353.   │     of the modification,
  354.   │ ■   cause the modified files to carry prominent notices stating  that  you
  355.   │     changed the files and the date of any change,
  356.   │ ■   cause the executable code of such modified version to clearly identify
  357.   │     itself as such in the course of its normal operation,
  358.   │ ■   If the modified version is not a "port",  but  operates  in  the  same
  359.   │     hardware and/or software environment  as  the  original  distribution,
  360.   │     make the original version equally available, clearly identifying  same
  361.   │     as the original, unmodified version;
  362.   │ ■   cause the whole of any work that you distribute or  publish,  that  in
  363.   │     whole or in part contains or is a derivative of RBBSMail or  any  part
  364.   │     thereof, to be licensed at no charge to all  third  parties  on  terms
  365.   │     identical to those contained in this License  Agreement  (except  that
  366.   │     you may choose to grant more extensive warranty protection to some  or
  367.   │     all third parties, at your option),
  368.  
  369.  
  370.     Legal Stuff                                                              5
  371.  
  372.  
  373.  
  374.                                  RBBSMail v18.1
  375.  
  376.  
  377.   │ ■   You may not  charge  a  distribution  fee  for  the  physical  act  of
  378.   │     transferring a  copy.   You  may  not  offer  warranty  protection  in
  379.   │     exchange for a fee.
  380.  
  381.   │ 4 - Mere aggregation of another unrelated program with  this  program  and
  382.   │ documentation  (or  derivative  works)  on  a  volume  of  a  storage   or
  383.   │ distribution medium does not bring the other program under  the  scope  of
  384.   │ these terms.
  385.  
  386.   │ 5 - You may copy and distribute RBBSMail and its associated  documentation
  387.   │ (or a portion or derivative of it, under Paragraph 2) in  object  code  or
  388.   │ executable form under the terms of Paragraphs 1, 2 and  3  above  provided
  389.   │ that you also do one of the following:
  390.  
  391.   │ accompany it with the complete corresponding machine-readable source code,
  392.   │ which must be distributed under the terms of Paragraphs 1, 2 and 3 above,
  393.  
  394.   │ OR
  395.  
  396.   │ accompany it with a written offer, valid for at least three years, to give
  397.   │ any third party free a complete machine-readable copy of the corresponding
  398.   │ source code, to be distributed under the terms of Paragraphs 1,  2  and  3
  399.   │ above,
  400.  
  401.   │ OR
  402.  
  403.   │ accompany  it  with  the  information  you  received  as  to   where   the
  404.   │ corresponding source code may be obtained.  (This alternative  is  allowed
  405.   │ only for noncommercial distribution and only if you received  the  program
  406.   │ in object code or executable form alone.)
  407.  
  408.   │ For an executable file, complete source code means all the source code for
  409.   │ all modules it contains.  As exception, it need not  include  source  code
  410.   │ for modules which are standard libraries that accompany the compiler  used
  411.   │ to generate the object code or libraries that are part  of  the  operating
  412.   │ system on which the executable file runs.
  413.  
  414.   │ 6 - You may not copy, sublicense, distribute or transfer RBBSMail and  its
  415.   │ associated documentation except as expressly provided under  this  License
  416.   │ Agreement.  Any attempt  otherwise  to  copy,  sublicense,  distribute  or
  417.   │ transfer RBBSMail is void and your rights to use the  program  under  this
  418.   │ License agreement shall be automatically terminated.  However, parties who
  419.   │ have received computer  software  programs  from  you  with  this  License
  420.   │ Agreement will not have their licenses terminated so long as such  parties
  421.   │ remain in full compliance, and notify Jan R.  Terpstra of their  intention
  422.   │ to comply with this Agreement.
  423.  
  424.   │ 7 - If you wish to incorporate parts of RBBSMail into other free  programs
  425.   │ whose  distribution  conditions  are  different,  please  contact  Jan  R.
  426.   │ Terpstra at the address listed below.  There's not yet a simple rule  that
  427.   │ can be stated here, but it will usually be permitted this.  Such  decision
  428.   │ is guided  by  the  two  goals  of  preserving  the  free  status  of  all
  429.   │ derivatives of this free software (as it pertains to Non-Commercial use as
  430.   │ provided by this Agreement) and of promoting  the  sharing  and  reuse  of
  431.  
  432.  
  433.     Legal Stuff                                                              6
  434.  
  435.  
  436.  
  437.                                  RBBSMail v18.1
  438.  
  439.  
  440.   │ software.
  441.  
  442.   │ 8 - For the purposes of this document,  "COMMERCIAL  USE"  is  defined  as
  443.   │ operation of the software with the intent of generating financial revenue,
  444.   │ where the revenue excesses the true  costs  of  running  the  organisation
  445.   │ (i.e.  profit).  The term  "COMMERCIAL  USE"  includes  use  by  religious
  446.   │ organisations, government agencies  and  organisation  raising  funds  for
  447.   │ third parties.
  448.   │ NON-PROFIT non-religious organization  or  individuals  may  operate  this
  449.   │ software under the terms of this Non-Commercial Agreement.
  450.  
  451.   │ 9 - You may terminate this license at any time by  simply  destroying  all
  452.   │ copies of the RBBSMail executables, sourcecode and documentation you  have
  453.   │ in your posession.
  454.  
  455.  
  456.   │ 3.2  NO WARRANTY
  457.  
  458.  
  459.   │ BECAUSE RBBSMail IS LICENSED FREE  OF  CHARGE,  I  PROVIDE  ABSOLUTELY  NO
  460.   │ WARRANTY.  EXCEPT WHEN OTHERWISE  STATED  IN  WRITING,  JAN  R.   TERPSTRA
  461.   │ AND/OR OTHER PARTIES PROVIDE RBBSMail "AS  IS"  WITHOUT  WARRANTY  OF  ANY
  462.   │ KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,  BUT  NOT  LIMITED  TO,  THE
  463.   │ IMPLIED  WARRANTIES  OF  MERCHANTABILITY  AND  FITNESS  FOR  A  PARTICULAR
  464.   │ PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE  OF  RBBSMail,
  465.   │ AND THE ACCURACY OF ITS ASSOCIATED DOCUMENTATION,  IS  WITH  YOU.   SHOULD
  466.   │ RBBSMail OR ITS ASSOCIATED DOCUMENTATION PROVE DEFECTIVE, YOU  ASSUME  THE
  467.   │ COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  468.  
  469.   │ IN NO EVENT WILL JAN R.  TERPSTRA  BE  RESPONSIBLE  IN  ANY  WAY  FOR  THE
  470.   │ BEHAVIOR OF MODIFIED VERSIONS OF  RBBSMail.   IN  NO  EVENT  WILL  Jan  R.
  471.   │ Terpstra AND/OR ANY OTHER PARTY WHO MAY MODIFY AND  REDISTRIBUTE  RBBSMail
  472.   │ AS PERMITTED ABOVE, BE LIABLE TO  YOU  FOR  DAMAGES,  INCLUDING  ANY  LOST
  473.   │ PROFITS, LOST  MONIES,  OR  OTHER  SPECIAL,  INCIDENTAL  OR  CONSEQUENTIAL
  474.   │ DAMAGES ARISING OUT OF THE USE OR INABILITY  TO  USE  (INCLUDING  BUT  NOT
  475.   │ LIMITED TO LOSS OF DATA  OR  DATA  BEING  RENDERED  INACCURATE  OR  LOSSES
  476.   │ SUSTAINED BY THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
  477.   │ OTHER PROGRAMS) RBBSMail, EVEN IF YOU HAVE BEEN ADVISED OF THE POSSIBILITY
  478.   │ OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  479.  
  480.   │ You can contact the author at address listed  on  the  titelpage  of  this
  481.   │ document.  Feel free to contact me at any  time  to  share  your  comments
  482.   │ about my software and/or  licensing  policies.   I  don't  always  listen,
  483.   │ though.
  484.  
  485.   │ For your info: RBBSMail was developed and tested on an IBM PS/2 mod70 with
  486.   │ 6MB memory and a 60MB fixed disk.   This  version  has  been  tested  with
  487.   │ RBBS-PC 17.3C, ConfMail v3.3, BinkleyTerm v2.50, oMMM  v1.70,  AMAX  v2.20
  488.   │ and Maximus CBCS v2.00.
  489.  
  490.   │ RBBSMail is entirely written  in  Microsoft  QuickC/QuickASM  v2.51.   All
  491.   │ development and testing was done under IBM PC-DOS 3.30 and DESQView  2.26.
  492.   │ RBBSMail was tested to run in the DOS boxes of MS Windos 3.0 and the  beta
  493.   │ 6.177 release of IBM OS/2 2.0.
  494.  
  495.  
  496.     Legal Stuff                                                              7
  497.  
  498.  
  499.  
  500.                                  RBBSMail v18.1
  501.  
  502.  
  503.   │ 3.3  NO MONEY
  504.  
  505.  
  506.   │ Non-Commercial users  may  us  this  software  free  of  charge.   If  you
  507.   │ absolutely insist on spending money for RBBSMail, DO NOT put  a  check  in
  508.   │ the mail to me.  In stead, take your wife or girlfriend (not both!) out to
  509.   │ dinner, to make up for the many, many hours you left her alone  while  you
  510.   │ were playing around with your BBS.......
  511.   │ Therefore, it is understood that RBBSMail is distributed as DINNERWARE.
  512.  
  513.   │ There's one absolute requirement for using this code: Send the  author  of
  514.   │ RBBSMail a nice postcard of a local scenery or from  your  next  vacation.
  515.   │ No windmills please :-)
  516.  
  517.  
  518.   │ 3.4  The RBBS commitment
  519.  
  520.  
  521.   │ A quote from the RBBS docs: "Most Bulletin Board Software is dedicated  to
  522.   │ making money for its authors.  No matter how much  the  authors  love  the
  523.   │ work, it endures only so long as the hope of income continues.
  524.   │ RBBS is given away for free, and depends not on the flow of money, but  on
  525.   │ the continuing dedication and generosity of people who volunteer  to  help
  526.   │ support and enhance it as a public service, and share their labor of  love
  527.   │ with others for the benefit of all."
  528.  
  529.   │ This statement fully applies to RBBSMail as well.
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.     Legal Stuff                                                              8
  560.  
  561.  
  562.  
  563.                                  RBBSMail v18.1
  564.  
  565.  
  566.     4. Installation
  567.  
  568.  
  569.     4.1  Configuring RBBSMail
  570.  
  571.  
  572.     Installation of RBBSMail  is  pretty  straightforward.   The  installation
  573.     procedure assumes that  you  have  installed  RBBS-PC  and  your  frontend
  574.     mailer, with all the conferences, the RBBS-PC control files  and  suitable
  575.     batch files.  You should already have obtained all the stuff you  need  to
  576.     run as a FIDONET node, things like NET/NODE number, the NODELIST and  some
  577.     programs to maintain all the files.  Please read the documentation of your
  578.     frontend mailer about this.  Talk to the Sysop  of  your  host-node  about
  579.     setting up your mail schedules and mailrouting.
  580.  
  581.     Now, copy RBBSMail.EXE to  the  directory  where  you  keep  your  RBBS-PC
  582.     MESSAGE files.  Find out the EXACT filenames of all  the  conferences  you
  583.     are going to hook up in the Echomail and find out by what AREA:names  they
  584.     are known in the network you are participating  in.   You  also  need  the
  585.     NET/NODE number(s) of the system(s) you are going exchange echomail  with.
  586.     You can send any AREA: to a large number of different  systems.   This  is
  587.     usually not the case, you will probably exchange mail with a small  number
  588.     of neigbouring nodes or only with your Echomail HOST, HUB or backbone.
  589.  
  590.     Most local FIDONET nets have a single hostnode with some  5  to  20  nodes
  591.     connected.  Ask the sysop of your local or regional HOST/HUB for the EXACT
  592.     AREA: names used in your net.
  593.     RBBSMail can run your system as Echomail host so you can set up  your  own
  594.     local or regional net.
  595.  
  596.     If you have all  info  needed,  you  must  build  two  control  files  for
  597.     RBBSMail.  One is RBBSMAIL.CFG, containing the information RBBSMail  needs
  598.     to make your system talks to the rest of the net.  The other is AREAS.BBS,
  599.     the control file that lists all echomail areas  you  exchange  with  other
  600.     nodes.  We'll talk about AREAS.BBS later on.
  601.     The format of RBBSMAIL.CFG file has a layout similar to the  configuration
  602.     files used by BinkleyTerm, MsgEd and other FIDONET utilities.  In fact you
  603.     can run RBBSMail, MsgEd and BinkleyTerm using only a single  configuration
  604.     file by writing "application rbbsmail" in front of the  RBBSMail  specific
  605.     configuration  phrases  in  BINKLEY.CFG.   Refer   to   section   "Reading
  606.     BINKLEY.CFG" in this manual or  the  BinkleyTerm  documentation  for  more
  607.     info.
  608.  
  609.  
  610.     4.2  Valid phrases for RBBSMAIL.CFG
  611.  
  612.  
  613.     4.2.1  Address
  614.  
  615.     Up to 10 FULL ZONE:NET/NODE.POINT addresses.  For  normal  operation,  the
  616.     full FIDONET address(es) under which you are listed in the nodelist.   For
  617.     point operation, it is the full 4-dimensional address of your point.   For
  618.     point operation, RBBSMail will translate the  address  internally  to  the
  619.     proper fakenet address.  (See also the PRIVATENET phrase).
  620.  
  621.  
  622.     Installation                                                             9
  623.  
  624.  
  625.  
  626.                                  RBBSMail v18.1
  627.  
  628.  
  629.     You may specify up to 9 additional addresses (i.e.   AKA,  Also  Known  As
  630.     addresses).  The FIRST address listed in the  configration  file  will  be
  631.     used as your primary address.  The additional addresses  are  ignored  for
  632.     point operation.
  633.  
  634.     For compatability with the BinkleyTerm configuration file, you may  either
  635.     write your primary address as the full ZONE:NET/NODE.POINT@domain  address
  636.     or specify (override) it with  the  the  DOMAIN  configuration  phrase  in
  637.     RBBSMAIL.CFG.
  638.     Only the domain name of your primary address  is  used,  domains  for  AKA
  639.     addresses are ignored.
  640.  
  641.  
  642.     4.2.2  ARCto, ARJto, PAKto, LHAto, ZIPto, ZOOto.
  643.  
  644.     RBBSMail can use different compression methods  for  outgoing  ARCmail  to
  645.     different addresses.  You can tell RBBSMail what compression method to use
  646.     for a certain address by using the PAKto, ARJto,  LHAto,  ZIPto  or  ZOOto
  647.     configuration phrases in the format:
  648.  
  649.         XXXto <address> <address> <address> <address>
  650.  
  651.     This is perhaps best illustrated with an excerpt from a RBBSMAIL.CFG file:
  652.  
  653.          ARJto 8:900/1                 ; this one gets ARJ mail
  654.          LHAto 1:1/1                   ; he prefers LHA (LHARC)
  655.          PAKto 2:512/8                 ; this node gets PAK format ARCmail
  656.          ZIPto 2:555/666 2:789/789     ; but these guys can only handle ZIP mail
  657.          ZOOto 2:1010/2 2:1010/3       ; and finally a 2 ZOO lovers
  658.  
  659.     If an address is not listed for one of the preferred compression  methods,
  660.     RBBSMail will default to  old  style  ARCmail  compatible  mailbundles  by
  661.     calling the program ARCA.
  662.     For this option to work properly, the executable  files  ARJ.EXE  PAK.EXE,
  663.     LHA.EXE, PKZIP.EXE and ZOO.EXE must be in the current subdirectory or in a
  664.     subdirectory listed in your DOS PATH.
  665.  
  666.     These ARCmail options  have  only  effect  when  using  the  command  line
  667.     switches -OF or -FA.
  668.     When using command line switches -OB or -OP, an external  mailpacker  (see
  669.     PACK configuration phrase) will be invoked and RBBSMail will not  use  the
  670.     internal ARCmail routines.
  671.  
  672.  
  673.     Warning to ARCmail users:
  674.     If you run Binkley as frontend mailer and oMMM as mailpacker, BE SURE that
  675.     both RBBSMail's ARCmail options  and  oMMM's  Stuffer<tm>  options  invoke
  676.     compression methods for the individual destination  nodes!  Otherwise  the
  677.     destination node may receive  an  ARCmail  bundle  containing  mailbundles
  678.     compressed by different compression programs.
  679.     If you use RBBSMail's internal ARCmail routines (either  the  -FA  or  -OF
  680.     command line switch) and ALSO run oMMM to  compress  and  route  ARCmailed
  681.     mailbundles, you may want to employ Johan Zwiekhorst's ARCA simulator.  If
  682.     you  do  not  configure  any  of  RBBSMail's  ARCmail  options  or  oMMM's
  683.  
  684.  
  685.     Installation                                                            10
  686.  
  687.  
  688.  
  689.                                  RBBSMail v18.1
  690.  
  691.  
  692.     stuffer<tm> options, both programs will happily use Johan's ARCA simulator
  693.     as a drop-in replacement for ARCA.
  694.  
  695.     Johan's ARCA simulator has an external configuration file that allows  you
  696.     to set different compression methods for different destination  addresses.
  697.     Using the ARCA simulator will ensure that the same compression program  is
  698.     used for each individual destination node,  both  by  RBBSMail  and  OMMM.
  699.     Plus you only need to change  ARCA's  config  file  if  your  distribution
  700.     changes and you don't  have  to  bother  with  either  RBBSMail's  ARCmail
  701.     options or oMMM's stuffer<tm> option.
  702.  
  703.  
  704.     4.2.3  Domain
  705.  
  706.     This is the common name of the network you are  a  member  of  under  your
  707.     PRIMARY net/node number.  DOMAIN is used to  build  the  MSGID:  tags  for
  708.     messages originating from your system and can be any  valid  domain  name:
  709.     RBBSNet, FIDONET, Eggnet, AlterNet or whatever network you are in.
  710.  
  711.  
  712.     4.2.4  DupSize
  713.  
  714.     Tells RBBSMail how many message identifications of impoted  messages  (per
  715.     conference)  it  should  store  for  purpose  of  checking  for  duplicate
  716.     messages.  The value can be 0...  3200, default is  512.   A  value  of  0
  717.     disables the duplicate checkig entirely.
  718.  
  719.     A higher value for DupSize makes RBBSMail  perform  slightly  slower  when
  720.     importing messages.
  721.     For systems with a low load of echomail, DupSize 200 will do.  On  systems
  722.     with an average load of echomail, the default is probably a  good  enough.
  723.     If you often find duplicate messages not caught by RBBSMail, increase  the
  724.     value of DupSize.
  725.  
  726.  
  727.   │ 4.2.5  ExportComments
  728.  
  729.   │ Normally, Comments and Private messages to Sysop aren't exported.  In case
  730.   │ you have a co-sysop running as one of your points,  he  may  wish  to  see
  731.   │ comments and private messages to sysop as well.  You can tell RBBSMail  to
  732.   │ export comments and private messages  to  sysop  with  this  configuration
  733.   │ phrase.
  734.   │ :mote
  735.   │ Be warned that potentially ANYONE can read whatever confidential  info  in
  736.   │ messages and comments to sysop once the message has left your system!!
  737.  
  738.  
  739.     4.2.6  Gate
  740.  
  741.     ZONE:NET/NODE address of a ZONEgate or ECHOgate  (HUB),  followed  by  the
  742.     NET/NODE number that should  appear  in  the  SEEN-BY  lines  in  messages
  743.     addressed to that gateway node.
  744.     Normally, a SEEN-BY line to an ECHOgate  or  ZONEgate  only  contains  the
  745.     gate's NET/NODE and the NET/NODE (and applicable AKA  addresses)  of  your
  746.  
  747.  
  748.     Installation                                                            11
  749.  
  750.  
  751.  
  752.                                  RBBSMail v18.1
  753.  
  754.  
  755.     own system.  You may define up to 10 gates.  Ignored for point operation.
  756.  
  757.     If you are serving as Echomail hostsystem and also send echoes to the host
  758.     of another net, you and the other  hosts  are  only  concerned  about  the
  759.     SEEN-BY info for your respective nets only and there is no need  to  carry
  760.     all SEEN-BY info over to the other net.  The two host systems only have to
  761.     tell each other the fact that they have seen the message.  All other  info
  762.     about what happened to the message in the one net is of no interest to the
  763.     other net.  Having a short SEEN-BY line keeps down the mailcost  for  ZONE
  764.     and ECHO gates.
  765.  
  766.  
  767.     4.2.7  Hold
  768.  
  769.     This is the subdirectory where RBBSMail  writes  outgoing  mailbundles  or
  770.     ARCmailed bundles.
  771.     If you send echomail to other zones than the zone your in, you  also  need
  772.     to have the proper subdirectories for outbound mail to  those  zones.   If
  773.     "HOLD C:\BINKLEY\HOLD" is specified as outbound subdirectory and you  send
  774.     mail  to  Zone  8,  the  subdirectory  C:\BINKLEY\HOLD.008  must  also  be
  775.     present.
  776.  
  777.  
  778.     4.2.8  ImportDate
  779.  
  780.     This phrase tells RBBSMail to stamp local messages with the CURRENT  date,
  781.     not with the  date  the  message  was  originally  entered.   All  impoted
  782.     messages will carry the date/time stamp of  the  moment  the  message  was
  783.     imported to your system.  If you kill messages by age,  then  the  message
  784.     age will be calculated  from  the  moment  the  message  arrived  on  your
  785.     system.  In echomail conferences with a high amount  of  traffic  you  may
  786.     wish to kill messages after a short time.  Thus  there's  a  chances  that
  787.     your message maintenance utility will kill an imported  message  the  same
  788.     day.
  789.  
  790.     Note: This option works for RBBS-PC style messages files only.
  791.  
  792.  
  793.     4.2.9  Indomain
  794.  
  795.     See section "CrossZone  Echomail"  for  information  about  setting  up  a
  796.     Network Gateway system.  This phrase is ignored for POINT operation.
  797.  
  798.  
  799.     4.2.10  KillNull
  800.  
  801.     This phrase tells RBBSMail to discard all messages without human  readable
  802.     contents.  Control information  (i.e.   any  text  "hidden"  by  a  Ctrl-A
  803.     kludge") is not treated as human readable text.  This option is especially
  804.     usefull to automatically kill FileAttach, FileRequest or empty messages.
  805.  
  806.     This option can also be switched on with the -KN commandline switch.
  807.  
  808.  
  809.  
  810.  
  811.     Installation                                                            12
  812.  
  813.  
  814.  
  815.                                  RBBSMail v18.1
  816.  
  817.  
  818.     4.2.11  LogLevel
  819.  
  820.     This phrase tell RBBSMail which error  messages,  progress  messagess  and
  821.     reports it should write to the logfile.  Loglevel can be any value between
  822.     0 and 4, which has the following effect
  823.  
  824.     0         Do not write to the log at all.
  825.     1         Only log critical errors.
  826.     2         Log critical and non-critical errors.
  827.     3         Log critical errors, non-critical errors and progress messages.
  828.     4         Log critical errors, non-critical errors, progress messages  and
  829.               statistics.
  830.  
  831.     See also configuration phrase StatusLog.
  832.  
  833.  
  834.     4.2.12  MaxOut
  835.  
  836.     This tells RBBSMail after how many exported messages it should invoke  the
  837.     mailpacking routine.  When the -OB or -OP command line  switch  is  given,
  838.     RBBSMail will invoke the external mailpacker.  See also  the  PACK  phrase
  839.     below.
  840.     If the -FA or -OF comandline  switch  is  given,  RBBSMail  will  run  the
  841.     internal ARCmail routines each time after MaxOut messages are exported.
  842.  
  843.     By packing outgoing mail  each  time  a  certain  number  of  messages  is
  844.     exported, your outgoing mailbundles will  be  relatively  small  in  size.
  845.     Some other echomail processors, like ConfMail, work more effectively  with
  846.     small mailbundles.  The number behind MaxOut can be between 1  and  32676.
  847.     A value between 25 and 250 is recommended.
  848.  
  849.  
  850.     4.2.13  NetFile
  851.  
  852.     Subdirectory  where  RBBSMail  can  find  incoming   FTS-0001   compatible
  853.     mailbundles.
  854.  
  855.  
  856.     4.2.14  NoRts
  857.  
  858.     Normally,  RBBSMail  returns  all  incorrect  echomail  messages  to   the
  859.     orignator and tosses a copy to the BAD_MSGS area for later inspection.  If
  860.     the phrase NoRts is present, RBBSMail will not return  incorrect  messages
  861.     to the sender.
  862.     See also the -S command  line  option  and  the  SecureMail  configuration
  863.     phrase.
  864.  
  865.  
  866.     4.2.15  NoStinkingKludgeLines
  867.  
  868.     This option causes RBBSMail to strip all redundant "kluge lines" from  all
  869.     incoming echomail messages.  Only AREA, EID,  MSGID,  REPLY,  SEEN-BY  and
  870.     PATH kludges will be left intact.  All others, including idiocy like  PID,
  871.     OSE and Via will be removed from the echomail messages.
  872.  
  873.  
  874.     Installation                                                            13
  875.  
  876.  
  877.  
  878.                                  RBBSMail v18.1
  879.  
  880.  
  881.     4.2.16  OpusDate
  882.  
  883.     This phrase tells RBBSMail to write all FIDO  style  (*.MSG)  messages  as
  884.     Opus/Maximus compatible files.  RBBSMail adds extra date/time info to  the
  885.     message header.  This allows you to do maintenance on those message  bases
  886.     using Opus or Maximus utilities like Renum and ReplyLink.
  887.  
  888.  
  889.     4.2.17  Pack
  890.  
  891.     The name the external packer program to be invoked by RBBSMail  to  packup
  892.     your outgoing mail.  This normally calls oMMM or a  similar  mail  packing
  893.     program to bundle and route outgoing mail.  See  also  the  MaxOut  phrase
  894.     above.
  895.  
  896.     The program listed after PACK can be either a BATchfile that invokes  your
  897.     mail packer or the name and parameters of your mail packer.  A PACK  batch
  898.     file (for example named PACKMAIL.BAT) can look something like this if  you
  899.     use BinkleyTerm, ReMapper and oMMM:
  900.  
  901.       ECHO OFF
  902.       CD\BINKLEY
  903.       REMAPPER 9999 -fpi
  904.       oMMM -iBINKLEY.PRM -m\BT\MAIL -h\BT\HOLD -c\BT\OMMM.CTL -sA -z2
  905.       CD\RBBS
  906.  
  907.     In this case, the RBBSMail entry should read
  908.  
  909.       PACK  C:\PACKMAIL.BAT
  910.  
  911.     Or the PACK parameter could list oMMM directly, with all parameters:
  912.  
  913.       PACK  oMMM -i\BINKLEY.PRM -m\BT\MAIL -h\BT\HOLD -c\BT\OMMM.CTL -sA -z2
  914.  
  915.     In this case, RBBSMail calls oMMM directly and you do not need a  separate
  916.     BATchfile to run oMMM.
  917.  
  918.     Today, it is very common to compress mailbundles before they are  sent  to
  919.     another system.  This will in some cases save over 50% of connect time  to
  920.     transfer mailbundles.  For INcoming mailbundles, RBBSMail recognizes  most
  921.     popular  compression  format  internally  and  will  invoke   the   proper
  922.     decompression program.  Mailbundles compressed by ARC/PAK/PKARC, ARJ,  LHA
  923.     (formerly known as LHARC), PKZIP and ZOO.  If the compression method of  a
  924.     mailbundle cannot be determnined, RBBSMail  will  try  to  invoke  GUS,  a
  925.     General Unpack Shell written by Johan Zwiekhorst.
  926.     for  this  to  work  properly,  the  executable  files  PAK.EXE,  LHA.EXE,
  927.     PKUNZIP.EXE, ZOO.EXE and GUS.EXE must be in the current subdirectory or in
  928.     a subdirectory listed in your DOS PATH environment variable.
  929.  
  930.     Note: If you decide to use this RBBSMail feature, BE SURE you have  enough
  931.     memory to run RBBSMail, oMMM and ARCA on top of  each  other!  320KB  free
  932.     memory when starting RBBSMail with this feature is the bare minimum.
  933.  
  934.  
  935.  
  936.  
  937.     Installation                                                            14
  938.  
  939.  
  940.  
  941.                                  RBBSMail v18.1
  942.  
  943.  
  944.     4.2.18  PrivateNet
  945.  
  946.     Is the NETnumber of your private network for points.  RBBSMail will  strip
  947.     all point addresses from the SEEN-BY: lines in outgoing mail, but  retains
  948.     the addresses locally.  PRIVATENET is mandatory for both  Boss  AND  point
  949.     operation.
  950.  
  951.  
  952.     4.2.19  Size
  953.  
  954.     Maximum size (in BYTES) of incoming messages.  All  messages  larger  than
  955.     this will be ignored.  RBBSMail's internal limit is 32000  bytes  for  all
  956.     messages, but you may want to set this to a lower value.
  957.  
  958.     Note: Most sysops pay the bill for Echomail out of their  own  pocket,  so
  959.     messages in the Echomail should be kept small.  Sending Echomail  messages
  960.     that are over 10KB in size may be considered anti-social.....
  961.  
  962.  
  963.     4.2.20  Security
  964.  
  965.     The security all imported messages are set to.  A  user  has  to  have  at
  966.     least this access level  to  read  any  imported  Echomail.   Ignored  for
  967.     messages in FIDO style message subdirectories.
  968.  
  969.  
  970.     4.2.21  SecureMail
  971.  
  972.     This phrase tells RBBSMail to  always  handle  echomail  in  secure  mode.
  973.     Effectively this tells RBBSMail to always assume that the -S comand switch
  974.     was given.
  975.     See the -S command line option for details.
  976.  
  977.  
  978.     4.2.22  StatusLog
  979.  
  980.     The name of the logfile to use.  If no StatusLog  is  specified,  filename
  981.     RBBSMAIL.LOG is used.
  982.     See also the LogLevel configuration prhase.
  983.  
  984.  
  985.     4.2.23  StripSeen
  986.  
  987.     If this phrase is configured, RBBSMail will strip  the  SEEN-BY  and  PATH
  988.     lines from all messages imported to  RBBS-PCstyle  message  bases.   Since
  989.     messages in RBBS-PC conferences are never exported once they're  imported,
  990.     the SEEN-BY and PATH lines have no  purpose  once  the  message  has  been
  991.     written to a RBBS-PC conference file.  The echomail control lines  can  be
  992.     stripped to save some diskspace.
  993.  
  994.     If you ever need inspect  the  flow  of  the  echomail  distribution,  for
  995.     instance if your systems receives  lots  of  duplicate  messages  or  just
  996.     because you're curious, you do need the echomail control lines.  If so, do
  997.     not set StripSeen in RBBSMAIL.CFG.
  998.  
  999.  
  1000.     Installation                                                            15
  1001.  
  1002.  
  1003.  
  1004.                                  RBBSMail v18.1
  1005.  
  1006.  
  1007.     4.2.24  SysAlias
  1008.  
  1009.     The alias name sysop uses to logon remotely to  RBBS-PC.   Beginning  with
  1010.     RBBS-PC v16.1A, the sysop's alias  name  is  listed  in  the  USERS  file.
  1011.     RBBSMail needs to know this alias to find the sysop  entry  in  the  USERS
  1012.     file to be able to flip the 'messages waiting' indicator for the sysop.
  1013.  
  1014.  
  1015.     4.2.25  Sysop
  1016.  
  1017.     The name you are normally known under as sysop of this  system.   Whatever
  1018.     you specify here will be overridden if you specify a SYSOP name after  the
  1019.     Origin line in AREAS.BBS.
  1020.  
  1021.  
  1022.     4.2.26  Reading BINKLEY.CFG
  1023.  
  1024.     Like noted before, RBBSMail is capable of using the configuration file  of
  1025.     other programs like BinkleyTerm's configuration file.   The  configuration
  1026.     phrases Address, Netfile, Hold, Sysop and  Privatenet  are  read  directly
  1027.     from Binkleyterm's configuration file.
  1028.     RBBSMail configuration phrases can be  added  to  BINKLEY.CFG  by  putting
  1029.     APPLICATION RBBSMAIL in front of the configuration phrase.
  1030.     For example, to enter the SECURITY phrase in BINKLEY.CFG, add the line:
  1031.  
  1032.        Application RBBSMail Security 4
  1033.  
  1034.     See the BinkleyTerm documentation for more info.
  1035.  
  1036.     Note: As RBBSMAIL cannot read nested configuration files, you  cannot  use
  1037.     the INCLUDE statement in your BINKLEY.CFG file.
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.     Installation                                                            16
  1064.  
  1065.  
  1066.  
  1067.                                  RBBSMail v18.1
  1068.  
  1069.  
  1070.     4.2.27  Example of a RBBSMAIL.CFG file
  1071.  
  1072.  
  1073.       ; Lines starting with a ';' are comment lines.  BLANK lines are ignored.
  1074.       ;
  1075.       Address    2:512/10.0
  1076.       Address    2:512/101.0
  1077.       Address    8:998/1.0
  1078.       Address    8:998/0.0
  1079.       Domain     FIDONET
  1080.       NetFile    C:\BT\NETFILES\
  1081.       Hold       C:\BT\HOLD\
  1082.       PrivateNet 9999
  1083.       SysAlias   Buck Rogers
  1084.       Sysop      John Software
  1085.       Size       9000
  1086.       Security   4
  1087.       Gate       1:1/0  1/0 512/10 101
  1088.       Gate       2:2/0  2/0 512/10 101
  1089.       Gate       3:3/0  3/0 512/10 101
  1090.       Gate       8:8/0  8/0 512/10 926/0 1
  1091.       Pack       C:\BINKLEY\PACKMAIL.BAT
  1092.       ZIPto      2:2512/10 2:512/101
  1093.       PAKto      8:926/1
  1094.       NoStinkingKludgeLines
  1095.       SecureMail
  1096.       DupSize    1024
  1097.       ImportDate
  1098.  
  1099.     (another example is included in this package, see file EXAMPLE.CFG).
  1100.     Put the config file RBBSMAIL.CFG  in  your  RBBS-PC  directory,  edit  the
  1101.     entries to reflect your specific system setup and remove all comments  for
  1102.     speed.
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.     Installation                                                            17
  1127.  
  1128.  
  1129.  
  1130.                                  RBBSMail v18.1
  1131.  
  1132.  
  1133.     The second file you need is named AREAS.BBS (for historic reasons).   This
  1134.     file lists all the conferences you want to hook up to Echomail, the  AREA:
  1135.     tag for that conference and the NET/NODE  number  you  want  to  send  the
  1136.     Echomail to.
  1137.  
  1138.  
  1139.     4.2.28  Example of an AREAS.BBS file
  1140.  
  1141.  
  1142.       ; Lines starting with ';' or '-' are comment lines, so are BLANK lines
  1143.       ; First non-commented line has the Origin line ! optional SYSOP name
  1144.       The Tennis Court, Herejezusveen, The Netherlands ! John Software
  1145.       ; all subsequent lines have either
  1146.       ;   RbbsFileName  AreaName  SendToList
  1147.       ; or
  1148.       ;   MsgSubdir     AreaName  SendToList
  1149.       ;
  1150.       ; You MUST at least have the areas NETMAIL and BAD_MSGS in your AREAS.BBS file
  1151.       ; Per conference, you can have up to 50 destination zone:net/node numbers.
  1152.       C:\BINK\NETMAIL\    NETMAIL
  1153.       C:\BINK\BAD_MSGS\   BAD_MSGS
  1154.  
  1155.       C:\RBBS\TENNISM.DEF +TENNIS  2:512/1 2 8:926/1 8:999/1 2:1234/1 2
  1156.       C:\RBBS\IBMPCM.DEF  -IBM-PC  2:512/1 2 3 12 8:926/1
  1157.       C:\RBBS\RBBSM.DEF   RBBS-PC 2:512/1 6 8:926/1
  1158.       C:\BINK\SYSOPS\     SYSOP   2:512/1
  1159.       C:\BINK\PASSTHRU\   WINDOWS 2:512/1
  1160.       C:\BINK\PASSTHRU\   XMODEM  2:512/1
  1161.  
  1162.     (see also EXAMPLE.BBS in this package).
  1163.  
  1164.     This AREAS.BBS example will have the following result:
  1165.  
  1166.     ■   The string "The Tenniscourt, Herejezusveen, The Netherlands"  will  be
  1167.         used as the * Origin: line in all outgoing Echomail  originating  from
  1168.         your system.  This way, anybody on any other system  will  know  where
  1169.         the message was originally entered.
  1170.  
  1171.     ■   If an outgoing message has SYSOP in the  address  field,  it  will  be
  1172.         replaced by the name John Software.  This way, other sysops  will  not
  1173.         find that message addressed to themselves, avoiding confusion.
  1174.         If you specify the OPTIONAL sysop name this way, it will overrride the
  1175.         SYSOP entry of RBBSMAIL.CFG.
  1176.  
  1177.     ■   If an incoming message has John Software in the address field, it will
  1178.         be replaced by SYSOP.  This way, the message scan function of  RBBS-PC
  1179.         will identify those messages as being addressed to SYSOP.
  1180.  
  1181.     ■   All messages in the file TENNISM.DEF will be sent to nodes  512/1  and
  1182.         512/2 in ZONE 2, to nodes 926/1 and 999/1 in zone 8, and they will  be
  1183.         sent to the nodes in the private (point) network  1234/1  and  1234/2.
  1184.         When sent out, an AREA: tag TENNIS will be put in the  first  line  of
  1185.         the message.  This way the receiving system on  the  other  end  knows
  1186.         what to do with the message.  When importing incoming  mail,  messages
  1187.  
  1188.  
  1189.     Installation                                                            18
  1190.  
  1191.  
  1192.  
  1193.                                  RBBSMail v18.1
  1194.  
  1195.  
  1196.         with an AREA: tag TENNIS will be put in the TENNISM.DEF file.
  1197.  
  1198.     ■   The area SYSOPS does not refer to an RBBS-PC MESSAGES file, but  to  a
  1199.         subirectory that  holds  FIDO  style  messages.   If  a  message  with
  1200.         AREA:SYSOPS  is  received,  it  will  be  moved  to  the  subdirectory
  1201.         C:\BINK\SYSOPS\, where it can be read by an appropriate message editor
  1202.         like MsgEd or Dutchie's Editor.  RBBSMail sees the difference  between
  1203.         RBBS-PC MESSAGES files and FIDO subdirectories by itself.  If RBBSMAil
  1204.         finds that a message base is a real file, a RBBS-PC MESSAGES  file  is
  1205.         assumed.  If the message base is a subdirectory, RBBSMail  will  treat
  1206.         the conference as a FIDO style message subdirectory.
  1207.  
  1208.     ■   You can probably figure out by yourself what happens to the other  two
  1209.         conference files RBBS-PC and IBM-PC? Well, sort of......
  1210.  
  1211.     There are two special cases in this example of AREAS.BBS, the WINDOWS  and
  1212.     the XMODEM area.  They are listed  using  the  same  message  subdirectory
  1213.     C:\BINK\PASSTHRU\.  This may look like mixing up  two  entirely  different
  1214.     echomail conferences, but it isn't.  If RBBSMail finds  that  an  echomail
  1215.     uses the special subdirectory  PASSTHRU,  it  will  normally  process  all
  1216.     messages for that area.  All checking for proper  control  echomail  lines
  1217.     and duplicates will be performed, but a local copy  of  the  message  will
  1218.     never be written.  The echomail is just "passing  through"  and  does  not
  1219.     actually exist on the local system.  An empty  subdirectory  \PASSTHRU  is
  1220.     needed for this feature.
  1221.     This comes in quite handy if a system is forwarding  echomail  for  others
  1222.     because it has a cheap phone line or  has  cheap  calls  to  two  or  more
  1223.     neighbouring telephone districts.
  1224.  
  1225.     You may add a '+' or a '-' in front of the area name.  The  line  defining
  1226.     the TENNIS conference tells RBBSMail to allow import and export of private
  1227.     messages, i.e.  the message's attributes will remain unchanged.  The  line
  1228.     defining the IBMPC-PC conference tell RBBSMail  to  discard  all  messages
  1229.     that have a message attribute of Private.
  1230.     By default, RBBSMail will force all incoming and outgoing messages in  all
  1231.     conferences to  be  PUBLIC  messages,  except  for  private  messages  and
  1232.     comments to sysop.
  1233.  
  1234.     This example has all your Echomail information in one file.  You may  have
  1235.     different AREAS.BBS-type files with different names and  different  Origin
  1236.     lines.  For instance, you could have a TENNIS.BBS file like:
  1237.  
  1238.       The Tennis Court, Herejezusveen, The Netherlands ! John Software
  1239.       C:\RBBS\TENNISM.DEF +TENNIS  2:512/1 2 8:926/1 8:999/1 2:1234/1 2
  1240.  
  1241.     Or an IBMPC.BBS file with:
  1242.  
  1243.       The Tennis Court, IBM PC Tech support, The Netherlands ! John Software
  1244.       C:\RBBS\IBMPCM.DEF -IBM-PC  2:512/1 2 3 12 8:926/1
  1245.  
  1246.     When you invoke RBBSMail SCAN explicitly giving  TENNIS.BBS  or  IBMPC.BBS
  1247.     (see  next  chapter)  it  will  take  the  sysop  name,  Origin  line  and
  1248.     distribution info from that file.  This way, you can put different  things
  1249.     in you Origin line and process  Echomail  conferences  separately  and  at
  1250.  
  1251.  
  1252.     Installation                                                            19
  1253.  
  1254.  
  1255.  
  1256.                                  RBBSMail v18.1
  1257.  
  1258.  
  1259.     different times.
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.     Installation                                                            20
  1316.  
  1317.  
  1318.  
  1319.                                  RBBSMail v18.1
  1320.  
  1321.  
  1322.     5. Running RBBSMail
  1323.  
  1324.  
  1325.     Beginning with version 18.0, a number of safeguards  have  been  build  in
  1326.     RBBSMail to ensure RBBS-PC MESSAGES file integrity while TOSSing mail into
  1327.     RBBS-PC style conferences.  You do not need to bring down all  your  nodes
  1328.     when running RBBSMail.  You can have users reading  and  writing  messages
  1329.     on-line while at the same  have  RBBSMail  handle  incoming  and  outgoing
  1330.     echomail.
  1331.  
  1332.     There is one  requirement  to  maintain  message  base  integrity.   Using
  1333.     RBBS-PC's CONFIG program, you must set the option "Message file  grows  as
  1334.     messages are added" to  YES  and  the  "Maximum  number  of  messages  per
  1335.     conference" must be set to 999 RBBSMail will not work  properly  if  these
  1336.     values are set otherwise.
  1337.  
  1338.     Unlike previous versions of RBBSMail, version 18.x imports and exports all
  1339.     echomail in ONE  single  sweep.   There's  no  need  to  specifically  run
  1340.     RBBSMail TOSS or RBBSMail SCAN.  Also, the MAINT mode of RBBSMail has been
  1341.     removed, there is now a separate program  RBBSMNT  to  do  maintenance  on
  1342.     RBBS-PC's messages files.
  1343.  
  1344.  
  1345.     5.1  Commandline options
  1346.  
  1347.  
  1348.     5.1.1  -A <areasbbsfile>
  1349.  
  1350.     Use an alternate areas listing.  RBBSMail defaults to AREAS.BBS (i.e.   -A
  1351.     AREAS.BBS).
  1352.  
  1353.  
  1354.     5.1.2  -AKA #
  1355.  
  1356.     Use # of AKA addresses (# is a number from 1 to 10).  This tells  RBBSMail
  1357.     to put '#' of your AKA addresses in the  SEEN-BY:  lines.   Addresses  are
  1358.     counted from top to bottom in your RBBSMAIL.CFG file.  The  first  address
  1359.     is used as your primary address, subsequent ADDRESS phrases are treated as
  1360.     AKA addresses.  RBBSMail uses no AKA addresses by default.
  1361.  
  1362.  
  1363.     5.1.3  -BM
  1364.  
  1365.     This switch tells RBBSMail to import messages from the BAD_MSGS area.   If
  1366.     you connected a new echomail area but did not create  that  area  on  your
  1367.     system or list it in your AREAS.BBS file, then RBBSMail will toss messages
  1368.     for that area to your BAD_MSGS subdirectory.
  1369.     Instead of manually moving these messages to your  netmail  directory  and
  1370.     importing them after you've created the appropriate area, just create  the
  1371.     area, list it in your AREAS.BBS and run RBBSMail -BM to import the  failed
  1372.     messages.
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.     Running RBBSMail                                                        21
  1379.  
  1380.  
  1381.  
  1382.                                  RBBSMail v18.1
  1383.  
  1384.  
  1385.     5.1.4  -C <configfile>
  1386.  
  1387.     The -C: switch allows you to use <configfile> as  alternate  configuration
  1388.     file.  Default is RBBSMAIL.CFG (i.e.  -C RBBSMAIL.CFG)
  1389.  
  1390.  
  1391.     5.1.5  -FA
  1392.  
  1393.     Send outgoing  echomail  as  FileAttached  ARCmail.   This  switch  forces
  1394.     RBBSMail to build compressed mailbundles and  a  FilAttach  message.   Use
  1395.     this option  if  your  frontend  mailer  does  NOT  use  oMMM  as  message
  1396.     packer/router.
  1397.     The FileAttach messages can  then  be  processed  by  the  frontend's  own
  1398.     message router.  This is Recommended if RBBSMail is  used  in  combination
  1399.     with Dutchie or SEAdog.  This option disregards  the  external  mailpacker
  1400.     and uses RBBSMail's internal ARcmail handler.
  1401.     See also the MaxOut, PACK and ARCmail configuration phrases.
  1402.  
  1403.     Note: NEVER change the status of the FileAttach messages  RBBSMail  writes
  1404.     in your netmail subdirectory.  These messages are used by RBBSMail to keep
  1405.     track of sent and unsent ARCmail bundles and  should  not  be  changed  or
  1406.     deleted.
  1407.  
  1408.     Note: The -FA, -OB, -OF and -OP switches are mutually exclusive.
  1409.  
  1410.  
  1411.     5.1.6  -H
  1412.  
  1413.     Use the FTS-0001 approved Ctrl-A kludge to hide the  SEEN-BY  lines.   For
  1414.     compatability only, NOT recommended for real life use.
  1415.  
  1416.  
  1417.     5.1.7  -I
  1418.  
  1419.     Process INBOUND mail only.  This command line switch tells  RBBSMail  that
  1420.     is should only process the incoming mailbundles for import and not  export
  1421.     the messages that were entered locally.  This option especially usefull on
  1422.     echomail backbones and apssthru nodes receiving echomail all  through  the
  1423.     day, but have little or no messages entered locally.
  1424.  
  1425.  
  1426.     5.1.8  -KN
  1427.  
  1428.     Kill all messages without human readable contents.
  1429.     See also the KillNull configuration phrase.
  1430.  
  1431.  
  1432.     5.1.9  -OB
  1433.  
  1434.     Build Outbound Bundles.  This forces RBBSmail to write  outgoing  echomail
  1435.     in  the  HOLD  subdirectory  as  oMMM/Binkley/Opus  compatbile  .OUT  type
  1436.     mailbundles.  A suitable mailpacker like oMMM can be used at a later  time
  1437.     to pack and route the outgoing mail.
  1438.     See also the MaxOut and PACK configuration phrases.
  1439.  
  1440.  
  1441.     Running RBBSMail                                                        22
  1442.  
  1443.  
  1444.  
  1445.                                  RBBSMail v18.1
  1446.  
  1447.  
  1448.  
  1449.     Note: The -FA, -OB, -OF and -OP switches are mutually exclusive.
  1450.  
  1451.  
  1452.     5.1.10  -OF
  1453.  
  1454.     Build outbound FLO files like  oMMM  does.   After  writing  the  outgoing
  1455.     echomail as .OUT mailbundles, RBBSMail compresses the bundles  and  writes
  1456.     oMMM/Binkley compatible FLO files to the outbound subdirectory.   The  FLO
  1457.     files are used by Binkley to determine where to send the mailbundles.  The
  1458.     status of FLO files can be handled manually or automatically  by  oMMM  or
  1459.     AMAX.
  1460.     See also the MaxOut, PACK and ARCmail configuration phrases.
  1461.  
  1462.     Note: The -FA, -OB, -OF and -OP switches are mutually exclusive.
  1463.  
  1464.  
  1465.     5.1.11  -OP
  1466.  
  1467.     Build Outbound Packets.  This command line switch causes RBBSMail to write
  1468.     outgoing  echomail  as  SEAdog  compatible  .PKT   files   in   the   Hold
  1469.     subdirectory.  The bundles may then be processed at  a  later  time  by  a
  1470.     suitable packer/router.
  1471.  
  1472.     Note: The -FA, -OB, -OF and -OP switches are mutually exclusive.
  1473.  
  1474.  
  1475.     5.1.12  -P
  1476.  
  1477.     Protect  bundles.   Normally,  after  RBBSMail  uncompresses  and  unpacks
  1478.     incoming mailbundles, the bundles  are  deleted.   In  some  cases,  other
  1479.     programs may wish to do something with the incoming mailbundles too.   The
  1480.     -P  command  line  option  causes  RBBSmail  uncompress  and  unpack   the
  1481.     mailbundles normally, but it leaves all processed bundles intact.
  1482.  
  1483.     The program  processing  the  bundles  left  by  RBBSMail  should  be  run
  1484.     IMMEDITATELY after RBBSMail is done.  If not, there  may  be  old  bundles
  1485.     left the next time RBBSMail run.   RBBSMail  will  then  unpack  the  same
  1486.     bundles again and will  find  all  messages  in  the  old  bundles  to  be
  1487.     duplicate messages.
  1488.  
  1489.  
  1490.     5.1.13  -S
  1491.  
  1492.     Operate in secure mode.   This  forces  RBBSMail  to  check  all  incoming
  1493.     echomail to originate from an addess that is listed in AREAS.BBS.   If  an
  1494.     echomail message is received from an address that is  NOT  listed  in  the
  1495.     distribution list for that area, the message is  tossed  in  the  BAD_MSGS
  1496.     subdirectory  and  a  copy  of  the  offending  message,  with   a   short
  1497.     explanation, is returned to the originator.  message
  1498.     See also the SecureMail and NoRts configuration phrases.
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.     Running RBBSMail                                                        23
  1505.  
  1506.  
  1507.  
  1508.                                  RBBSMail v18.1
  1509.  
  1510.  
  1511.     5.1.14  -T
  1512.  
  1513.     Use Tiny SEEN-BY  lines.   This  will  force  RBBSMail  to  put  only  the
  1514.     addresses from the distribution list (AREAS.BBS)  in  the  SEEN-BY  lines.
  1515.     Use with extreme care,  tiny  SEEN-BY  lines  have  been  known  to  cause
  1516.     duplicate messages in networks that suffer from circular  distribution  of
  1517.     echomail.
  1518.  
  1519.  
  1520.     5.1.15  -X
  1521.  
  1522.     Exclude processing of the netmail subdirectory.  This forces  RBBSMail  to
  1523.     look for  incoming  echomail  as  mailbundles  or  ARCmail  bundles  only.
  1524.     Greatly speeds up the import of incoming mail.
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.     Running RBBSMail                                                        24
  1568.  
  1569.  
  1570.  
  1571.                                  RBBSMail v18.1
  1572.  
  1573.  
  1574.     6. A word on echomail distribution
  1575.  
  1576.  
  1577.     When RBBSMail is invoked, it will  read  the  lines  of  RBBSMAIL.CFG  and
  1578.     AREAS.BBS.  If  there  are  distribution  lists  in  the  AREAS.BBS  file,
  1579.     RBBSMail first searches all echomail conferences (RBBS-PC  MESSAGES  files
  1580.     and FIDO style message bases) for new messages and sends copies  of  these
  1581.     messages to their destionations.
  1582.     RBBSMail does a few checks before it exports a message.  If the TO or FROM
  1583.     field of a message contains "SYSOP", it is replaced by the  sysops's  real
  1584.     name.  This hopefully prevents confusion about "what sysop the message  is
  1585.     addressed to?" when the message arrives on other systems.
  1586.  
  1587.     RBBS-PC  allows  users  of  the  BBS  to  enter  comments  to   SYSOP   in
  1588.     conferences.  If  the  SUBJECT  filed  of  a  message  contains  the  word
  1589.     "COMMENT", the message is not exported.
  1590.     Depending on the setting of '+' and '-' in AREAS.BBS, RBBSMail wil  ignore
  1591.     private messages, send them as-is or force them to be public messages.
  1592.  
  1593.     If a message contains NOECHO (just one word, in UPPER case) as  the  first
  1594.     line of the message text, RBBSMail will NOT send that message out  on  the
  1595.     network.  So, if there's anything to be said in  a  conference  that  only
  1596.     concerns users on YOUR system, put NOECHO as first line of the message and
  1597.     that message will not be send to other systems.  Inform your  users  about
  1598.     this feature!
  1599.  
  1600.     During the process of exporting messages, new messages will be tagged with
  1601.     an MSGID:  (Message  Identification)  tag  at  the  top  of  all  outgoing
  1602.     messages.  The MSGID: tag is a unique message  identifier  in  the  format
  1603.     MSGID: Z:N/N/P yyyyyyyy
  1604.  
  1605.       where:
  1606.       Z:N/N.P is your full Zone:Net/Node.Point address
  1607.       yyyyyyyy = a DOS style date&time marker.
  1608.  
  1609.     The date/time stamp plus the 16 bit CRC of the From, To and Subject fields
  1610.     of the message are used to generate an identifier  that  can  be  used  to
  1611.     check for duplicate messages.  Another identifier  is  stored  in  a  file
  1612.     named xxxx.DUP (where xxxx is the name of the current  conference).   This
  1613.     is a wrap around file, holding the IDs of the last incoming  and  outgoing
  1614.     echo messages for each area.
  1615.     The number of message IDs (and thus the size of the dups file) can be  set
  1616.     with the configuration phrase DupSize in RBBSMAIL.CFG.
  1617.  
  1618.     Next,  RBBSMAil  looks  for  incoming  mail  in  the  MAIL   and   NETFILE
  1619.     directories.  After checking for proper addressing and duplicate messages,
  1620.     RBBSMail will send a copy of the incoming messages to the destination list
  1621.     and then toss it to either the appropriate RBBS-PC conference  or  to  the
  1622.     proper FIDO style message subdirectory listed in AREAS.BBS.
  1623.     If there is no  RBBS-PC  conference  file  or  FIDO  message  subdirectory
  1624.     related to the AREA:tag, the message is tossed to the BAD_MSGS area.
  1625.  
  1626.     When importing mail, RBBSMail will look for a USERS file belonging to  the
  1627.     conference it writes any message to.  This USERS file is scanned  for  the
  1628.  
  1629.  
  1630.     A word on echomail distribution                                         25
  1631.  
  1632.  
  1633.  
  1634.                                  RBBSMail v18.1
  1635.  
  1636.  
  1637.     name the message is addressed  to.   If  the  name  is  found,  the  'mail
  1638.     waiting' bit for this user will be flipped ON.  If you use  the  new  mail
  1639.     notification or the [V]iew conferences feature of RBBS-PC (i.e.  you  have
  1640.     a CONFMAIL.DEF type file), users can quickly check for  new  mail  in  the
  1641.     conferences, without having to access each conference separately.
  1642.  
  1643.     Note: USERS file update only works for RBBS-PC  MESSAGES  files,  not  for
  1644.     FIDO style message subdirectories.
  1645.  
  1646.     Echomail messages addressed to net/node numbers other than  your  net/node
  1647.     number(s) are tossed to the BAD_MSGS directory.   NETmail  messages  (i.e.
  1648.     messages without an AREA:tag) are ignored and left intact in  the  NETMAIL
  1649.     directory.
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.     A word on echomail distribution                                         26
  1694.  
  1695.  
  1696.  
  1697.                                  RBBSMail v18.1
  1698.  
  1699.  
  1700.     7. A word on RBBS-PC MESSAGES files
  1701.  
  1702.  
  1703.     7.1  Filesizes
  1704.  
  1705.  
  1706.     When you installed RBBS-PC, it required you to tell it what the  size  (in
  1707.     128 byte records) of your MESSAGES files should be,  how  many  lines  per
  1708.     message you allow and what the maximum amount  of  active  messages  in  a
  1709.     particular MESSAGE file should be.  RBBSMail has its own ideas  about  the
  1710.     size of a message, so you should take a few precautions.
  1711.     Configure RBBS-PC to use MESSAGES files that grow as messages  are  added,
  1712.     and set the maximum  amount  of  messages  to  999.   RBBSMail  will  then
  1713.     automatically manage the size of the MESSAGES  files  for  you.   RBBSMail
  1714.     will always check the number of free records in any MESSAGES  file  before
  1715.     it starts processing that file.  If there is not sufficient room  left  to
  1716.     process the newly entered message in a MESSAGES file,  RBBSMail  will  not
  1717.     process the file.  If, for some reason, the MESSAGES file is  full  before
  1718.     the RBBSMail is done, the MESSAGES file will be expanded to ensure that no
  1719.     messages are lost.
  1720.  
  1721.     As there are no restrictions to  the  size  of  FIDONET  messages,  it  is
  1722.     possible that you receive mail with more lines per message than  you  have
  1723.     pre-set in RBBS-PC's CONFIG program.
  1724.  
  1725.     You should periodically review the behaviour of your MESSAGES files.   Kim
  1726.     Wells' MU-PURGE program shows statistics about the amount of used and free
  1727.     space in your MESSAGES files.
  1728.  
  1729.     Sometimes RBBSMail just hangs up in the middle of  a  SCAN  or  TOSS  run.
  1730.     This is usually caused by a broken link in the MESSAGES file.  A  possible
  1731.     reason for having your MESSAGES files messed up is that MU-PURGE choked on
  1732.     a message that was too big to process.  If you run MU-PURGE on a  MESSAGES
  1733.     file with a lot of *big* messages, MU-PURGE  will  sometimes  run  out  of
  1734.     memory and abort, leaving a broken chain in the MESSAGES file.
  1735.  
  1736.     It is therefore HIGHLY advised to set the SIZE parameter  in  RBBSMAIL.CFG
  1737.     to a value of 12000 or less.
  1738.  
  1739.     If the above happens, the most elegant way to recover is:
  1740.  
  1741.         - Use RBBS-PC's CONFIG program to repair the broken MESSAGES file.
  1742.         - Use RBBS-PC's CONFIG program to pack the MESSAGES file.
  1743.         - Start RBBS-PC and kill the first message in the  MESSAGES  file  you
  1744.         just repaired.
  1745.         - Decrease the value of the SIZE parameter in RBBSMAIL.CFG.
  1746.  
  1747.  
  1748.     7.2  Filenames for CONFERENCES
  1749.  
  1750.  
  1751.     Let's take the TENNIS conference from the  above  examples.   You  have  a
  1752.     TENNISM.DEF file that holds all the messages and a TENNISU.DEF  file  that
  1753.     holds all users of the TENNIS conference.  If you create a file TENNIS.ORG
  1754.  
  1755.  
  1756.     A word on RBBS-PC MESSAGES files                                        27
  1757.  
  1758.  
  1759.  
  1760.                                  RBBSMail v18.1
  1761.  
  1762.  
  1763.     in the same directory your  TENNISM.DEF  and  TENNISU.DEF  files  are  in,
  1764.     RBBSMail will take the FIRST line from this file and use it as the text in
  1765.     your Origin line.
  1766.     So,  for  all  conferences  or  subboards  on  your  system,  the   naming
  1767.     conventions should be:
  1768.  
  1769.     xxxxM.def the Messages file of conference with name 'xxxx'
  1770.     xxxxU.def the Users file of conference with name 'xxxx'
  1771.     xxxx.DUP  the file containing the IDs of messages already imported in this
  1772.               conference.  You  shouldn't  bother  with  this  file,  RBBSMail
  1773.               handles it for you.
  1774.     xxxx.ORG  the file  containing  the  text  of  the  Origin  line  for  the
  1775.               conference with filename 'xxxxM.DEF'
  1776.  
  1777.     For FIDO style message subdirectory,  a  file  named  DUPDATA.DAT  in  the
  1778.     subdirectory holds the IDs.
  1779.  
  1780.  
  1781.     7.3  Filenames for SUBBOARDS
  1782.  
  1783.  
  1784.     RBBS-PC allows any valid DOS filename  for  MESSAGE  and  USERS  files  in
  1785.     subboards.  By not using the standard RBBS-PC xxxxM.DEF naming convention,
  1786.     MESSAGES files are not accessible by the [J]oin conference command,  which
  1787.     is exactly what you want for a subboard.
  1788.     This poses a bit of a problem for RBBSMail, for it has no way of  figuring
  1789.     out the names of MESSAGE and  USERS  files  in  subboards,  execept  maybe
  1790.     reading the RBBSxPC.DEF files for each conference and/or subboard.  Due to
  1791.     the many changes of the RBBS-PC.DEF file in every new version of  RBBS-PC,
  1792.     this is highly unreliable.
  1793.  
  1794.     Therefore, RBBSMail uses the following convention for  MESSAGE  and  USERS
  1795.     files that are not named according to the standard RBBS-PC  xxxxM.DEF  and
  1796.     xxxxU.DEF method:
  1797.  
  1798.     ABCXYZ    the MESSAGES file of a subboard (NO extension!)
  1799.     ABCXYZ.USRthe USERS file of the subboard with ABCXYZ as MESSAGE file (.USR
  1800.               extension is mandatory!)
  1801.     ABCXYZ.DUPthe file  containing  the  IDs  of  messages  imported  in  this
  1802.               conference.  You  shouldn't  bother  with  this  file,  RBBSMail
  1803.               handles it for you.
  1804.     ABCXYZ.ORGthe file containing the  text  for  the  Origin  line  for  this
  1805.               subboard.
  1806.  
  1807.     In short:
  1808.     If your RBBS-PC MESSAGE and USERS files are named in the form of xxxxM.DEF
  1809.     with an accompanying xxxxU.DEF file, RBBSMail will strip  off  the  M.DEF,
  1810.     and ONLY the significant part of the MESSAGES file's filename  (i.e.   the
  1811.     conference name) will be  used  to  identify  the  xxxx.ORG  and  xxxx.DUP
  1812.     files.
  1813.     If your RBBS-PC MESSAGE and USERS files (for subboards) only consist of  a
  1814.     filename with no extension, the whole name of the files will  be  used  to
  1815.     identify xxxx.ORG and xxxx.DUP files.
  1816.  
  1817.  
  1818.  
  1819.     A word on RBBS-PC MESSAGES files                                        28
  1820.  
  1821.  
  1822.  
  1823.                                  RBBSMail v18.1
  1824.  
  1825.  
  1826.     7.4  Filenames for FIDO style subdirs
  1827.  
  1828.  
  1829.     In a FIDO style message subirectory, all messages are  in  separate  files
  1830.     with the extension '.MSG" (i.e.  message 1 will  be  1.MSG).   The  naming
  1831.     convention for FIDO style message bases differs somewhat  from  the  above
  1832.     method of naming files for RBBS-PC conferences and subboards.
  1833.  
  1834.     To have a separate text for the Origin  lines  in  a  FIDO  style  message
  1835.     subirectory, simply put a file with the name ORIGIN (no extension) in that
  1836.     particular subdirectory.  This is the equivalent  of  the  xxxx.ORG  files
  1837.     mentioned avbove.
  1838.  
  1839.     The IDs of imported messages are stored in  the  subdirectory  in  a  file
  1840.     named DUPDATA.DAT.  It is the equivalent of the xxxx.DUP  files  mentioned
  1841.     above.
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.     A word on RBBS-PC MESSAGES files                                        29
  1883.  
  1884.  
  1885.  
  1886.                                  RBBSMail v18.1
  1887.  
  1888.  
  1889.     8. How to set up your mail
  1890.  
  1891.  
  1892.     8.1  What you need
  1893.  
  1894.  
  1895.     To get your mail in and out on the FIDONET, you need  a  number  of  other
  1896.     programs and files.  (Assuming you already have RBBS-PC running):
  1897.  
  1898.     ■   Frontend mailer (BinkleyTerm, Dutchie or d'Bridge)
  1899.     ■   oMMM, mOOO or Packer, to pack up outgoing mailbundles
  1900.     ■   ARCA and ARCE or PKARC and PKXARC
  1901.     ■   If you  don't  want  RBBSMail  to  unpack  incoming  mailbundles,  use
  1902.         Confmail, QM  or  whatever  appropriate  program  to  unpack  incoming
  1903.         mailbundles.
  1904.     ■   A recent nodelist
  1905.     ■   PARSELST, a program to compile and update your nodelist
  1906.     ■   A mail-editor (Dutched or MSGED) to inspect incoming/outgoing mail  is
  1907.         strongly suggested.  It will be a great help getting started.
  1908.  
  1909.     First, you need to set up the frontend mailer  and  the  schedules.   Your
  1910.     local or regional HOST or HUB has to supply the times when you should call
  1911.     him to deliver and pick up your mail.  There is an extensive chapter about
  1912.     setting up schedules (or events) and routing in the documentation of  your
  1913.     frontend mailer.
  1914.     If you want to have control over your schedules  from  within  your  batch
  1915.     files (i.e.  outside the scheduler of your mail frontend), you may want to
  1916.     look at the program WDATIME that is included  in  this  package.   WDATIME
  1917.     enables you to test Month, Date, Time and Day of the Week from within your
  1918.     batch files.
  1919.  
  1920.     It is STRONGLY recommended to make arrangements with your HOST or  HUB  to
  1921.     have him forward the weekly NODELIST or NODEDIFF files, so  your  nodelist
  1922.     will always be up to date.  See PARSELST.DOC how to set  up  an  automatic
  1923.     update of your nodelist.
  1924.     If  your  HOST  or  HUB  carries  the  weekly  FIDO  newsletter  or  other
  1925.     newsletters of interest, ask him to forward it to you.  There is a lot  of
  1926.     useful information in some of these regular newsletters.
  1927.  
  1928.     After you set up your frontend mailer and your schedules, you are ready to
  1929.     run.
  1930.     Well, sort of.....  While setting up the events and the bulky  batch  file
  1931.     you need to run your system plus mailer, you should  also  stick  in  some
  1932.     lines containing the proper RBBSMail commands at the proper  places.   I'm
  1933.     afraid you are on your own on this, there is no boilerplate for  it.   You
  1934.     should at least run RBBSMail shortly BEFORE your main mail event  (usually
  1935.     the National Mail Hour) and AFTER the NMH.  If you run  mail  outside  the
  1936.     NMH, you can run RBBSMail as often as you may need for other events.
  1937.     Again, you have to decide on this in agreement with whatever other systems
  1938.     you exchange mail with.
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.     How to set up your mail                                                 30
  1946.  
  1947.  
  1948.  
  1949.                                  RBBSMail v18.1
  1950.  
  1951.  
  1952.     8.2  A quick overview
  1953.  
  1954.  
  1955.     1.  Run RBBSMail to export new messges from your system.
  1956.     2.  Run your mailpacker (oMMM, MOOO  or  whatever)  with  the  appropriate
  1957.         schedules and routings (contact your  host  for  the  routing).   Your
  1958.         outgoing mail is now ready to be sent.
  1959.     3.  Have your frontend mailer call all other  systems  you  exchange  mail
  1960.         with, or sit and wait for them to call you.
  1961.     4.  Run RBBSMail import/export the received Echomail.
  1962.     5.  You have now succesfully exchanged Echomail.  Congratulations!
  1963.  
  1964.  
  1965.     Note: If you have both FIDO/OPUS style messages  directories  AND  RBBS-PC
  1966.     MESSAGES files for your Echomail, you need TWO AREAS.BBS files IF you want
  1967.     the FIDO style conferences  to  be  processed  by  another  program.   For
  1968.     instance, you need an AREAS.BBS for ConfMail to process mail  to/from  the
  1969.     FIDO style subdirectories and an AREAS.BBS for RBBSMail  to  process  mail
  1970.     to/from the RBBS-PC MESSAGES files.  The  two  files  may  have  different
  1971.     names or may be located in different subdirectories.  You can NOT use  the
  1972.     same AREAS.BBS file for both ConfMail and RBBSMail.
  1973.  
  1974.  
  1975.     8.3  Enhanced Setup / CRITMON<tm>
  1976.  
  1977.  
  1978.     With combinations of different RBBSMAIL.CFG, AREAS.BBS and xxxx.ORG  files
  1979.     you can do CRITMON<tm>.  That is Creative Renaming In The  Middle  Of  The
  1980.     Nigth.  You can appear to the net as  two  or  more  completely  different
  1981.     systems.  Or run as one system in several different  networks.   Or  both.
  1982.     Or send all your outbound Echomail to yourself very night.  Or  cross-feed
  1983.     two of your echomail sources with a circular feed.  Or receive Echomail as
  1984.     123/1 and send the whole bunch back to your host as 789/2, thus  making  a
  1985.     lot of "friends".
  1986.  
  1987.     Don't rush to your keyboard  to  do  CRITMON<tm>  right  away.   Remember,
  1988.     Personal Computers can be used Personally, programmed Personally  and  you
  1989.     can Personally screw the thing up beyond belief.  Like me, you are  likely
  1990.     to do the latter.....
  1991.  
  1992.     Sit down with a big sheet of paper, a pencil and a pencil  eraser.   Setup
  1993.     an overview of what you want your system to do and  where  you  send  mail
  1994.     to.  Figure out the setup of your config files  and  your  schedule(s)  of
  1995.     events.  Then, make ONE setup and test it.  up your system for ONE of  the
  1996.     alternatives and test it.  With another sheet of paper,  setup  the  other
  1997.     alternatives, and test them one by one.  In any case,  don't  change  more
  1998.     than one thing at a time in your setup.  FUBAR is the word!
  1999.  
  2000.     RBBSMail will (in most cases) do faithfully what you want, even  with  the
  2001.     craziest setup.  If it doesn't do what you want, (and even if it does) you
  2002.     have yourself to thank for it.
  2003.  
  2004.     Since most of the address translation is done  completely  transparent  by
  2005.     RBBSMail, you usually need just ONE setup.
  2006.  
  2007.  
  2008.     How to set up your mail                                                 31
  2009.  
  2010.  
  2011.  
  2012.                                  RBBSMail v18.1
  2013.  
  2014.  
  2015.     8.4  Cross-zone echomail / CRITMON<tm>
  2016.  
  2017.  
  2018.     If you are a node in more than one Zone, RBBSMAIL will be  quite  creative
  2019.     when CRITMONning.  For instance, you run as 2:512/10 in FIDONET Zone 2 and
  2020.     as 8:998/1 in RBBSNet.  You  have  will  have  addresses  in  RBBSMAIL.CFG
  2021.     listed as:
  2022.  
  2023.       Address 2:512/10
  2024.       Address 2:2/508
  2025.       Address 8:998/1
  2026.  
  2027.     and a line in your AREAS.BBS lik this one:
  2028.  
  2029.         C:\RBBS\CHATM.DEF  CHATTER 2:512/1 2:9999/1 8:998/10
  2030.  
  2031.     Now, RBBSMail will export messages to  2:512/1  (your  FIDONET  host),  to
  2032.     2:9999/1 (one  of  your  points)  and  to  8:998/1  (your  RBBSNet  host).
  2033.     But.....   the  messages  sent  to  2:512/1  and  2:9999/1  will  have  an
  2034.     originating address of 2:512/10, and the messages to 8:998/10 will have an
  2035.     origin address of 8:998/1 in the binary message hader.
  2036.     Messages that were entered locally on your system will also have  variable
  2037.     addresses in the * Origin: line, depending on the destination address.
  2038.  
  2039.     However, the MSGID tag will ALWAYS have your primary address.  MSGID needs
  2040.     to be unique for every message and it is not a good idea  to  use  two  or
  2041.     more different 'unique' IDs.
  2042.     Same goes for  the  PATH  line,  which  will  ALWAYS  carry  your  primary
  2043.     address.
  2044.  
  2045.     In other words, RBBSMail  adjusts  the  originating  address  of  outgoing
  2046.     echomail messages to match the address you use in  the  destination  zone.
  2047.     This way, secure echomail distribution accross zones will be possible  and
  2048.     you don't have  to  bother  with  running  different  setups  for  sending
  2049.     echomail to different zones.
  2050.  
  2051.     Please note that RBBSMail will, by default, only put your PRIMARY  address
  2052.     in the SEEN-BY lines.  If you exchange mail with other systems  using  one
  2053.     of your alternate adresses, you must either  use  the  -AKA  command  line
  2054.     switch to tell RBBSMail to put one or more of your alternate addresses  in
  2055.     the SEEN-BY  line  or  configure  a  GATE  phrase  for  those  destination
  2056.     addresses.
  2057.  
  2058.     RBBSMail uses the same naming convention for  outbound  subdirectories  as
  2059.     BinkleyTerm and oMMM does.  If you have set your HOLD subdir like  in  the
  2060.     examples above, RBBSMail will write outbound  echomail  addressed  to  any
  2061.     node in your  own  zone  (in  this  case,  zone  2)  to  the  subdirectory
  2062.     C:\BT\HOLD.
  2063.     For  each  additional  destination  zone,  RBBSMail   needs   a   separate
  2064.     directory.  The additional directories simply get an  extension  (Yeah,  I
  2065.     know that subdirectory names aren't supposed to have extensions).
  2066.     The 3-digit hexadecimal representation of the destination zone  number  is
  2067.     used as extension.   Following  the  above  exapmles,  all  outbound  mail
  2068.     addressed to  Zone  4  is  written  to  the  subdirectory  C:\BT\HOLD.004,
  2069.  
  2070.  
  2071.     How to set up your mail                                                 32
  2072.  
  2073.  
  2074.  
  2075.                                  RBBSMail v18.1
  2076.  
  2077.  
  2078.     outbound stuff for zone 30 ends up in a subdirectory named  C:\BT\HOLD.01E
  2079.     and mail for zone 69 will be written the C:\BT\HOLD.045 subdirectory.
  2080.  
  2081.     If you run RBBSMail in  combination  with  BinkleyTerm  and/or  oMMM,  you
  2082.     probably already  have  these  additional  subdirectories  and  they  will
  2083.     automatically be used by RBBSMail.  If they aren't  there,  RBBSMail  will
  2084.     create additional subdirectories whenever it needs them.
  2085.  
  2086.     If you run RBBSMail with another frontend  mailer  than  BinkleyTerm,  you
  2087.     probably need to tell your mailer and/or mailpacker that it should look in
  2088.     the additional subdirectories for outbound mail to other  zones.   There's
  2089.     no need to bother about this if you use the -FA command line switch.   The
  2090.     FileAttach messages created by RBBSMail will alwys end up in your  NETmail
  2091.     directory, with the proper drive,  path  and  filename  for  the  attached
  2092.     mailbundle.
  2093.  
  2094.  
  2095.     8.5  Network Gateway Systems
  2096.  
  2097.  
  2098.     The Public Amateur Computer Network, commonly known as FIDONET, used to be
  2099.     the only system of linked bulletin boards in the world.  For the last  few
  2100.     years, new FIDO  compatible  networks  have  popped  up.   There  now  are
  2101.     AlterNet, Turbo Data Net and RBBSNet, to name a few.
  2102.     These networks are completely independent structures,  but  lately  people
  2103.     started exchanging Echomail  between  these  networks.   This  poses  some
  2104.     political  and  operational  problems.   Politics  should   be   left   to
  2105.     politicians, so I will only deal with the operational stuff.
  2106.  
  2107.     Let me give an example to clarify  the  problems.   Suppose  a  system  in
  2108.     FIDONET Zone 2 wants to exchange Echomail with a  system  in  the  RBBSNet
  2109.     (which uses zone 8 for practical purposes) and pass it on to other systems
  2110.     in the FIDONET.  All Echomail received from the RBBSNet systems will  list
  2111.     an address in the Origin line that is not a valid FIDONET address.
  2112.     Just passing this netmail through will probably get a FIDONET  coordinator
  2113.     up the wall, for FIDONET does not  like  to  carry  around  messages  with
  2114.     invalid (non-FIDONET) addresses.  As the RBBSNet system will not be in the
  2115.     FIDONET NODELIST with his RBBSNet node number, his RBBSNet nodenumber will
  2116.     be invalid in FIDONET, so we need to do something about that.
  2117.  
  2118.     For instance, FIDO 2:2/508.0 will serve as the inbound Network Gateway for
  2119.     Echomail from RBBSNet (which uses fake zone number 8) to FIDO zone 2.  All
  2120.     (or most) Echomail received from RBBSNet will list zone 8 addresses in the
  2121.     Origin lines.  To fullfill the above FIDONET  requirements,  all  messages
  2122.     that are send out by 2:2/508.0 to other  FIDONET  systems  should  have  a
  2123.     valid Origin address in the Origin line.  RBBSMail will take care of  this
  2124.     in a simple manner.
  2125.     The INDOMAIN phrase in RBBSMAIL.CFG should list the (fake) ZONE number  of
  2126.     the other network for which your system is the Network Gateway,  plus  the
  2127.     Origin line to be added to messages from the other network.  On 2:2/508.0,
  2128.     the INDOMAIN statement looks like this:
  2129.  
  2130.       INDOMAIN 8 RBBSNetwork Gateway to Europe (2:2/508.0)
  2131.  
  2132.  
  2133.  
  2134.     How to set up your mail                                                 33
  2135.  
  2136.  
  2137.  
  2138.                                  RBBSMail v18.1
  2139.  
  2140.  
  2141.     A practical example: A message entered on RBBSNet 8:926/1.0 will have that
  2142.     address listed in the Origin line.  When 2:2/508.0 receives this  messages
  2143.     and sends it out to a system in a zone OTHER than zone 8, the Origin  line
  2144.     will be zapped and an extra Origin line  "RBBSNetwork  Gateway  to  Europe
  2145.     (2:2/508.0)" will be added to the messages.  This  fullfills  the  FIDONET
  2146.     requirement of valid addresses.
  2147.     The conversion will ONLY take place for messages  that  originate  from  a
  2148.     system in the zone listed in the "INDOMAIN" phrase AND if  those  messages
  2149.     are sent to a system that is not in that zone.  Messages that stay  within
  2150.     the same zone or messages that originate from other  zones  will  be  left
  2151.     untouched.
  2152.  
  2153.     Only one INDOMAIN network gateway can be  defined  (there  ain't  no  such
  2154.     thing as an outdomain).  One should exercise  great  care  in  setting  up
  2155.     systems like this.  Contact your network or  zone  coordinator,  agree  on
  2156.     terms and conditions for operating the Network Gateway.  Be sure to inform
  2157.     other systems about the proper routing for mail that has to  pass  through
  2158.     the network gateway.
  2159.  
  2160.     The above method is rather simple and somewhat crude, but it has  been  in
  2161.     operation at 2:2/508 since September 1988 without problems.
  2162.  
  2163.  
  2164.     8.6  Error determination
  2165.  
  2166.  
  2167.     Sometimes it looks as if you just can't get it right.   If  you  encounter
  2168.     problems with RBBSMail, step thru the following procedure to diagnose  the
  2169.     situation.
  2170.  
  2171.     1.  RTFM.
  2172.     2.  Check the configuration files for  typos,  incorrect  drive,  path  or
  2173.         filenames.  Check contents of AREAS.BBS.  Change if needed.
  2174.     3.  RTFM again.
  2175.     4.  Check the command line for proper switches.  Change if needed.
  2176.     5.  Relax, have a cup of coffee and let the situation soak in for a while
  2177.     6.  Run the program again.
  2178.     7.  If the  symptoms  change,  repeat  the  above  steps  till  the  error
  2179.         'magically' disappears.
  2180.     8.  If the above steps fail, erase RBBSMail.LOG.
  2181.     9.  Run RBBSMail in the failing situation.
  2182.     10. Send me a CRASHmail  message  with  the  problem  properly  described.
  2183.         File-attach a copy of your setup files and a LOG file that  shows  the
  2184.         problem.  Feel free to include any other  relevant  information,  like
  2185.         type and version number of hardware and software you  use,  filesizes,
  2186.         AREAS.BBS and BINKLEY.CFG.   You  may  wish  to  include  examples  of
  2187.         failing messages or mailbundles.
  2188.     11. Poll my system after a few days to see if there's a reply for you.  If
  2189.         you have a real problem, and I'm not on  vacation,  there  will  be  a
  2190.         reply (and hopefully a fix) waiting.
  2191.     12. If there's no reply and I'm not on vacation, RTFM and repeat the above
  2192.         steps.
  2193.     13. Flames will never be dignified with an answer.
  2194.  
  2195.  
  2196.  
  2197.     How to set up your mail                                                 34
  2198.  
  2199.  
  2200.  
  2201.                                  RBBSMail v18.1
  2202.  
  2203.  
  2204.     8.7  Other stuff
  2205.  
  2206.  
  2207.     I'm sure you will have a lot of questions about Echomail.  It is a strange
  2208.     sort of animal to RBBS-PC sysops.  But, don't fear! Echomail  can  be  fun
  2209.     and can be a great enhancement to your system.  If, at  first,  you  don't
  2210.     understand what Echomail is all about, talk to a local OPUS or FIDO  sysop
  2211.     or to the sysop of the host in your local  network.   Sysops  are  strange
  2212.     birds, but very helpful and usually eager to show you around.  The  moment
  2213.     you have your Echomail running you'll see the benefits of it.
  2214.  
  2215.     If you decide to hook up your RBBS-PC system to the world of FIDONET,  you
  2216.     also  may  wish  to  take  part  in  several  RBBS-PC   related   Echomail
  2217.     conferences.  In the USA, contact your  local  host  system.   In  Europe,
  2218.     contact me by sending me a netmail message, and start polling for  mail  a
  2219.     few days later.
  2220.  
  2221.     And there are several Echomail  conferences  about  the  frontend  mailers
  2222.     BINKLEY (for BinkleyTerm), WINDMILL (for Dutchie) and FD (for  FrontDoor).
  2223.     If a local or regional HOST or  HUB  carries  a  conference  on  the  mail
  2224.     frontend you use, make arrangements to get the echo.  It will be of  great
  2225.     help to you.
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.     How to set up your mail                                                 35
  2261.  
  2262.  
  2263.  
  2264.                                  RBBSMail v18.1
  2265.  
  2266.  
  2267.     9. The RBBSNet
  2268.  
  2269.  
  2270.     Several RBBS-PC sysops have started  a  RBBSNet,  separate  from  FIDONET.
  2271.     Currently, there are a bunch of FIDO  compatible  networks  in  operation:
  2272.     FIDONET, EggNet, The People's Net, AlterNet, TuboDatanet and GT-Net.   I'm
  2273.     part of both FIDONET and RBBSNet, and my system is  the  European  gateway
  2274.     for RBBSNet (node 8:998/1.0  in  the  RBBSNet).   For  more  info  on  the
  2275.     RBBSNet, Contact Rod Bowman of the PC-Spectrum RBBS in Alta  Loma,  CA  at
  2276.     (714) 945-2612.  Rod has put an enormous amount of work in setting up  the
  2277.     RBBSNet.  I sure hope it will all work out.
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323.     The RBBSNet                                                             36
  2324.  
  2325.  
  2326.  
  2327.                                  RBBSMail v18.1
  2328.  
  2329.  
  2330.     10. Future enhancements
  2331.  
  2332.  
  2333.     10.1  Planned for new releases
  2334.  
  2335.  
  2336.     In order of priority:
  2337.  
  2338.     1.  Addition of Smart Zone and Point remapping
  2339.     2.  Addition of AutoEcho/AreaFix capabilities.
  2340.     3.  Addition of mailpacker/router (currently being written).
  2341.     4.  Full NETmail capability, but this is waiting for some major changes in
  2342.         RBBS-PC.
  2343.  
  2344.     If you have any comments, suggestions for enhancements or you  have  found
  2345.     something in RBBSMail that doesn't work the way it should,  feel  free  to
  2346.     contact me via Bamestra RBBS.  See the title page of this document for the
  2347.     node number and phonenumbers.  You may also leave a message in the RBBS-PC
  2348.     or RBBSMAIL_PACK Echomail conferences.
  2349.  
  2350.  
  2351.     10.2  Comments & Suggestions
  2352.  
  2353.  
  2354.     If you have comments on the workings  of  RBBSMail,  suggestions  for  new
  2355.     features, improvements or bug reports, feel free to send a NETmail message
  2356.     to Sysop at FIDO 2:512/10.0 (RBBSNet 8:998/1.0) or a written letter to the
  2357.     postal address listed on the title page.
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.     Future enhancements                                                     37
  2387.  
  2388.  
  2389.  
  2390.                                  RBBSMail v18.1
  2391.  
  2392.  
  2393.     Appendix A. Changes to RBBS-PC
  2394.  
  2395.  
  2396.     There is a conflict between RBBSMail's way of flagging messages  that  are
  2397.     processed and  "repair  message  file"  option  185  in  RBBS-PC's  CONFIG
  2398.     program.  RBBSMail changes the ":" (colon) in the datefield of the message
  2399.     header to a "." (dot) to flag a message.  CONFIG's option 185  will  choke
  2400.     on this, because it uses that same ":" to scan for valid message headers.
  2401.     This will result  in  mixed-up  message  numbering.   To  circumvent  this
  2402.     conflict, either do not use CONFIG option 185  (you  don't  normally  need
  2403.     that option), or remove the following line from linenumber 50580 of module
  2404.     CONFIG.BAS:
  2405.  
  2406.        AND MID$(MESSAGE.RECORD$,64,1) = ":" _
  2407.  
  2408.     This line appears TWICE in linenumber 50580.
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.     Appendix A. Changes to RBBS-PC                                          38
  2450.  
  2451.  
  2452.  
  2453.                                  RBBSMail v18.1
  2454.  
  2455.  
  2456.     Appendix B. Update history
  2457.  
  2458.  
  2459.     January 17, 1992 - Initial release of RBBSMail v18.0
  2460.  
  2461.     ■   Complete rewrite of RBBSMail in C.
  2462.     ■   Maintenance moved to a separate program RBBSMNT.
  2463.     ■   Buggy Zone and Point remapper removed.
  2464.  
  2465.     February 28, 1992 - release of RBBSMail v18.1
  2466.  
  2467.     ■   Added ExportComments configuration phrase.
  2468.     ■   Improved errorchecking for grunged bunldes.
  2469.     ■   Changed order in which ARCmail bundles are processed.
  2470.     ■   Fixed bug that incorrectly reported  inconsistent  header  records  in
  2471.         messages files.
  2472.     ■   Fixed bug that dumped copies of PASSTHRU messages in netmail area.
  2473.     ■   Fixed bug that incorrectly set message attributes on RTS messages.
  2474.     ■   Fixed bug in ARCmail address parsing (ARCto, ZIPto et al).
  2475.  
  2476.  
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.     Appendix B. Update history                                              39
  2513.  
  2514.  
  2515.  
  2516.                                  RBBSMail v18.1
  2517.  
  2518.  
  2519.     Table of Contents
  2520.  
  2521.     1. WARNING!  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  2522.  
  2523.     2. What is RBBSMail  . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  2524.  
  2525.       2.1  Software Requirements . . . . . . . . . . . . . . . . . . . . . . 2
  2526.       2.2  Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . 3
  2527.       2.3  Limitations.  . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  2528.       2.4  Related Documents . . . . . . . . . . . . . . . . . . . . . . . . 4
  2529.       2.5  Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . . 4
  2530.  
  2531.     3. Legal Stuff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  2532.  
  2533.       3.1  Copyrights & License  . . . . . . . . . . . . . . . . . . . . . . 5
  2534.       3.2  NO WARRANTY . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
  2535.       3.3  NO MONEY  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  2536.       3.4  The RBBS commitment . . . . . . . . . . . . . . . . . . . . . . . 8
  2537.  
  2538.     4. Installation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  2539.  
  2540.       4.1  Configuring RBBSMail  . . . . . . . . . . . . . . . . . . . . . . 9
  2541.       4.2  Valid phrases for RBBSMAIL.CFG  . . . . . . . . . . . . . . . . . 9
  2542.         4.2.1  Address . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  2543.         4.2.2  ARCto, ARJto, PAKto, LHAto, ZIPto, ZOOto.   . . . . . . . .  10
  2544.         4.2.3  Domain  . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  2545.         4.2.4  DupSize . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  2546.         4.2.5  ExportComments  . . . . . . . . . . . . . . . . . . . . . .  11
  2547.         4.2.6  Gate  . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  2548.         4.2.7  Hold  . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  2549.         4.2.8  ImportDate  . . . . . . . . . . . . . . . . . . . . . . . .  12
  2550.         4.2.9  Indomain  . . . . . . . . . . . . . . . . . . . . . . . . .  12
  2551.         4.2.10  KillNull . . . . . . . . . . . . . . . . . . . . . . . . .  12
  2552.         4.2.11  LogLevel . . . . . . . . . . . . . . . . . . . . . . . . .  13
  2553.         4.2.12  MaxOut . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  2554.         4.2.13  NetFile  . . . . . . . . . . . . . . . . . . . . . . . . .  13
  2555.         4.2.14  NoRts  . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  2556.         4.2.15  NoStinkingKludgeLines  . . . . . . . . . . . . . . . . . .  13
  2557.         4.2.16  OpusDate . . . . . . . . . . . . . . . . . . . . . . . . .  14
  2558.         4.2.17  Pack . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  2559.         4.2.18  PrivateNet . . . . . . . . . . . . . . . . . . . . . . . .  15
  2560.         4.2.19  Size . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  2561.         4.2.20  Security . . . . . . . . . . . . . . . . . . . . . . . . .  15
  2562.         4.2.21  SecureMail . . . . . . . . . . . . . . . . . . . . . . . .  15
  2563.         4.2.22  StatusLog  . . . . . . . . . . . . . . . . . . . . . . . .  15
  2564.         4.2.23  StripSeen  . . . . . . . . . . . . . . . . . . . . . . . .  15
  2565.         4.2.24  SysAlias . . . . . . . . . . . . . . . . . . . . . . . . .  16
  2566.         4.2.25  Sysop  . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  2567.         4.2.26  Reading BINKLEY.CFG  . . . . . . . . . . . . . . . . . . .  16
  2568.         4.2.27  Example of a RBBSMAIL.CFG file . . . . . . . . . . . . . .  17
  2569.         4.2.28  Example of an AREAS.BBS file . . . . . . . . . . . . . . .  18
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.     Table of Contents                                                       40
  2576.  
  2577.  
  2578.  
  2579.                                  RBBSMail v18.1
  2580.  
  2581.  
  2582.     5. Running RBBSMail  . . . . . . . . . . . . . . . . . . . . . . . . .  21
  2583.  
  2584.       5.1  Commandline options . . . . . . . . . . . . . . . . . . . . . .  21
  2585.         5.1.1  -A <areasbbsfile> . . . . . . . . . . . . . . . . . . . . .  21
  2586.         5.1.2  -AKA #  . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  2587.         5.1.3  -BM . . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  2588.         5.1.4  -C <configfile> . . . . . . . . . . . . . . . . . . . . . .  22
  2589.         5.1.5  -FA . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  2590.         5.1.6  -H  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  2591.         5.1.7  -I  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  2592.         5.1.8  -KN . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  2593.         5.1.9  -OB . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  2594.         5.1.10  -OF  . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  2595.         5.1.11  -OP  . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  2596.         5.1.12  -P . . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  2597.         5.1.13  -S . . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  2598.         5.1.14  -T . . . . . . . . . . . . . . . . . . . . . . . . . . . .  24
  2599.         5.1.15  -X . . . . . . . . . . . . . . . . . . . . . . . . . . . .  24
  2600.  
  2601.     6. A word on echomail distribution . . . . . . . . . . . . . . . . . .  25
  2602.  
  2603.     7. A word on RBBS-PC MESSAGES files  . . . . . . . . . . . . . . . . .  27
  2604.  
  2605.       7.1  Filesizes . . . . . . . . . . . . . . . . . . . . . . . . . . .  27
  2606.       7.2  Filenames for CONFERENCES . . . . . . . . . . . . . . . . . . .  27
  2607.       7.3  Filenames for SUBBOARDS . . . . . . . . . . . . . . . . . . . .  28
  2608.       7.4  Filenames for FIDO style subdirs  . . . . . . . . . . . . . . .  29
  2609.  
  2610.     8. How to set up your mail . . . . . . . . . . . . . . . . . . . . . .  30
  2611.  
  2612.       8.1  What you need . . . . . . . . . . . . . . . . . . . . . . . . .  30
  2613.       8.2  A quick overview  . . . . . . . . . . . . . . . . . . . . . . .  31
  2614.       8.3  Enhanced Setup / CRITMON<tm>  . . . . . . . . . . . . . . . . .  31
  2615.       8.4  Cross-zone echomail / CRITMON<tm> . . . . . . . . . . . . . . .  32
  2616.       8.5  Network Gateway Systems . . . . . . . . . . . . . . . . . . . .  33
  2617.       8.6  Error determination . . . . . . . . . . . . . . . . . . . . . .  34
  2618.       8.7  Other stuff . . . . . . . . . . . . . . . . . . . . . . . . . .  35
  2619.  
  2620.     9. The RBBSNet . . . . . . . . . . . . . . . . . . . . . . . . . . . .  36
  2621.  
  2622.     10. Future enhancements  . . . . . . . . . . . . . . . . . . . . . . .  37
  2623.  
  2624.       10.1  Planned for new releases . . . . . . . . . . . . . . . . . . .  37
  2625.       10.2  Comments & Suggestions . . . . . . . . . . . . . . . . . . . .  37
  2626.  
  2627.     Appendix A. Changes to RBBS-PC . . . . . . . . . . . . . . . . . . . .  38
  2628.  
  2629.     Appendix B. Update history . . . . . . . . . . . . . . . . . . . . . .  39
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.     Table of Contents                                                       41
  2639.